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1*0 SCOPE 



1.0 lCi3££ 



This document describes the external features and 

characteristics of CYBIt-CC Interactive Debugs a supervisor 
program running under the HQS operating system. It is primarily 
directed toward CYBER 180 software development programmers who 
are assumed to be familiar with CY3IL-CC and NQS* 



1.1 A££LiQ4aL£-.aacya£iiis 



HOS Reference Hanual Volume 1 60445^00 

NOS Reference Manual Volume 2 60445300 

Network Products Interactive Facility 

Version 1 Reference lianual 60455250 

Network Products Interactive Facility 

Users Gui de 60455260 

CYBER Interactive Debug 

Version 1 Reference Manual 60481400 

CY3IL language Specification ARH2298 

CY3IL V2.0 Implementation Dependent ARH3078 

Handbook 
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2.0 If^TRODUCTION 



2.0 miRaiiaaiiQ!! 



CYSIL-CC Interactive Debug (CCD3G) extends the capabilities of 
CY3ER Interactive Debug (CID) to allow symbolic debugging of 
CY3Il~CC programs. locations within a CYBIL-CC program can be 
referenced by variable names and line numbers if the program was 
compiled with the 0E8UG option selected* This option causes 
CY8IL-CC to produce special tables for CCD8G as part of the 
object code. 

The CID command syntax has been completely changed in CCDBG to 
make it conform with the NQS/180 System Command Language. Also# 
many changes have been made to the parameters of most commands to 
handle CY8II-CC modules* procedures and stacks instead of Fortran 
structures. The overall capabilities of CCD3G* however > differ 
little from those of CID. There are only four new 
commands! FORWARD* 8ACKWAR0, DISPLAY^OEFAULTS and 
CHANGE_DEFAULTS. The COiiPASS or machine 1 eve I cap abi I i t y of CID 
has been maintained* and the overall design of CID has not been 
changed. 



2.1 QltMlEU 



CCDBG is a supervisory program loaded in the user field length 
to operate on loaded object programs. No special source 
statements are needed In the program to be debugged! however* a 
spscia! co-npjler option njust bs ssJcctsd If symbolic debuggirig Is 
desired. In addition to its symbolic referencing capabilities* 
CCDSG controls program execution as determined by user-defined 
breakpoints and traps* allows the user to look at and change 
memory and registers* and defines a sequence of CCDBG commands 
and gives them a procedure name so that they will execute each 
time the name is referenced or on occurrence of a specified 
breakpoint or trap* Breakpoint* trap and procedure definitions 
may be saved on a file for use in future sessions* and the 
session may be checkpointed to be restarted later* 
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2.0 INTRODUCTION 
2.2^TERIiINQLQGY^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

2.2 KRiiiiiakasx 

Breakpoint A location within a program where the program's 

execution may be interrupted by a monitor routine. 

Default The name of the CYBIL-CC module that was executing 
liodule when CCD8G gained control* unless a subsequent 

CHANGE^DEFAUITS command specified a new module name 
as the default module. At initial start-up of 
CC08G> the default module is the module at which 
program execution is to begin. Default module is 
equivalent to HOME PROGRAM in CIO. 

Default The CY8II-CC procedure that was executing when 
Proc CCD8G gained control* unless a subsequent 

CHANGE^OEEAULTS command specified a new procedure 
name as the default proc. At initial start-up of 
CC08G* the default proc is undefined. 

Entry Point A special named location within a program which may 
be accessed by programs complied separately. If 
there Is an alias* the alias name will be used. 
Entry points are limited to 7 characters by the 
CYBER Loader* If they are longer than 7 characters* 
only the first 7 characters will be used. To 
reference an entrypoint that contains a character 
that is not legal in a name* the entrypoint name 
must be enclosed In single quotes. 

Expression An algorithm used for computing a value. A CC08G 

expression may contain symbolic address references* 
CCD3G variables* numeric literals* and the 
cpcrstors ^ ^trttj =. Thsy ~iay bs uscd to cxpfcss an 
address or a value. 

Heap A dynamic storage area explicitly allocated and 

freed by CYBIL-CC programs. 

Interactive Capable of a two-way back and forth exchange of 
informa t i on . 

Interpret Execution of computer machine instructions by other 
than direct means* A special routine examines each 
Instruction and simulates its execution. 

flap A list of module and entry point memory addresses* 

produced when the program Is loaded. 
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2.2 TERHINOLOGY 



Module A compilation unit in CY8IL-CC» This is the alias 
defined in CY3IL-CC or the first 7 characters of 
the module name if there is no alias. To reference 
a module which contains a character that is not 
legal in a name* the module name must be enclosed 
in single quotes* 

Nested A procedure that is defined within another 
procedure. 

Overlay A portion of a program which can share an area of 
memory with other similar program portions. When 
access to a particular portion of the program Is 
required* the overlay containing that portion Is 
loaded* overlaying the previous contents of the 
memory area. 

Procedure A named portion of a program in CYSIL-CC* This Is 
the actual name defined in CYSIL-CC* not an alias. 

Program The completely loaded set of one or more modules. 

Separator A character required between two items so that they 
may be distinguished. In CCD8G* spaces or commas 
are used as separators between parameters and 
between elements In a list* and semi-colons and 
end-of-Ilne are used as separators between 
commands. 

Stack A dynamic storage area automatically allocated by 
CY8IL-CC programs on each procedure call* 

Trace An ordered list of procedures or modules that have 

^ i ^ . .. -J ^ _ «._-__._— JC t ^ . . 



2.3 a£IiiAfiSU^££ 

Throughout this document* whenever a CCOBG command Is 
discussed* the manner of writing that command is illustrated with 
a uniform system of notation* This notation is called a 
metalanguage and is not part of CCD3G* Through the use of a 
metalanguage we are able to provide a brief* but precise* 
explanation of the general patterns that CCD8G permits. The 
metalanguage does not describe the meaning of the language 
elements* merely their structure! i.e.* it Indicates the order In 
which the elements may Cor must) appear* punctuation that Is 
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2,3 METALANGUAGE 



required* and options that are allowed* These following 

metalanguage rules apply! 

1) The syfTibol J:= is read as "IS DEFINED TO S£»»« 

2) Elements enclosed by < > are to be considered a single 
syntactic unit In relation to surrounding nraeta symbols. 

3) Elements enclosed by C ] are optional and are to be 
considered a single syntactic unit in relation to surrounding 
meta symbol s* 

4) Elements separated by J are mutually exclusivef and the 
symbol is read as ^'OR". 

5) Elements followed by •«• can be repeated* 

6) <••> will be used to indicate that an elMpsis (two or more 
periods) is required* In this case* the ellipsis ispart of 
the I angu age* 

7) <ascii> will be used to indicate that an ascii character is 

r equi red* 

8) <sp> will be used to indicate that a space is required* 

9) The symbol EOL will be used to indicate end of line* 



2.^ MSic.aQiii:££n 



<integer> ::« <dec_digit> C<dlglt>***1 C<<base>)3 

Integers may be expressed as octal (8)* decimal {10)> or 
hexadecimal M6J* When the base specification Is omittedf 
decimal {101 is assumed* \lhen a hexadecimal representation is 
specified* a leading zero may be required to ensure that the 
constant begins with a decimal digit* 



COnPANY PRIVATE 



COC - ADVANCEO S/STEflS DEVELOPMENT 
ERS for CY3IL-CC Interactive Debugger 



2-5 

09/29/80 
REVS 
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2,4,2 NAME 



2,4*2 NAHE 



<nafne> J:« <alpha> t<al pha>J <di gi t>3 • . • 

A name is a string of alphanumeric characters not contained in 
a coiament or constant. The name must be preceded and followed by 
a delimiter. Any character not allowed Inside a name delimits a 
name* The Initial character of a name must not be a digit and 
the number of characters in a name must not exceed 31* 



2.4.3 ADDRESS 



<address> ss* <expr> 

An address is an expression which when evaluatedf provides an 
18 bit central memory address or a 24 bit ECS address. 



2.4.4 CCOBG VARIABLES 



These variables are part of CCD8G and are available to the 
user* They all have identifiers beginning with #• Ten user 
variables designated #V1# #V2».*.##V10 may be changed by the 
user* The other variables may be accessed by the user# but may 

not be changed. 

Number of breakpoints currently defined* 

Number of traps currently defined. 

Number of debugger SCL procedures currently 
defined. 

Central memory field length* 

Program address register. 

Reprieve error code. 

Mode error code* 



#BP 


#TP 


$?R 


#FL 


#P 


#ERRCODE 


#CPUERR 



The following CC08G variables may only be accessed when CCDBG 
IS in interpret mode* 
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2«4,4 CCOBG VARIABLES 



#INS 
#INSL 

fPARCei 

#QP 

#1 

#J 

#K 

#EA 

#EW 

#PC 

#PA 



Current instruction as nufuber* 

Current instruction length {15> 30 or 60) 

Instruction parcel counter* 

OP code of current instruct! on» 

i field of current instruction* 

j field of current instruction* 

k or K field of current instruction* 

Effective address of current instruction* 

E f f ect i ve word* 

Previous contents* 

Previous address* 



2*4*5 EXPRESSION (EXPR) 



<expr> !!* C<operator>1 <oper3nd> C<oper atorXoper and>3 • • ♦ 

<operator> ?s* <+>J<-> 

<operand> ?s« <constant>* <na)Be>n <expr>) 

An expression ts an algorithm for computing a value* 



•3. A -A <:szQ M> KT no 



<sep> it' <sp>\<f> 

A comma or a space may be used to separate parameters or 
elements in a list* 



2*4.7 COMMENTS 



<comment> 3?* "<ascli> Kasci i >3* * **• 

Comments are not interpreted by CCOBG and serve only as 
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2.0 INTRODUCTIOH 
2. 4,7 COMMENTS 



documentation. A comment acts syntactically the same as a space; 
i*a.^ whenever a space is allowed a comment is allowed* and 
whenever a space is required as a deliisiter a comment will serve 
the same purpose. 



2.4.8 COMHANO 



<command> SJ* <command narae> C<sep><param llst>3 

A coffimand consists of the command name followed by any 
parameters necessary to control its operation. 



2.4.9 PARAHETER LISTS 



<param list> JS* <param> KsepXpar am>3 . » . 

A parameter list consists of a series of parameters separated 
by spaces or commas. Each parameter In the list can be specified 
In one of three formats. The first format consists simply of the 
parameter name. 

< par am name> 

The second format consists of the name followed by parameter 
text. 

<param naraeX » J <sp>> <param value> 

Both of the above formats are positionally independent! i.e.* 



|-h<a nrHof 






format Is positionally dependant and consists simply of parameter 
text. The positional significance of a parameter is one greater 
than the previous parameter specified in the list* Omission of a 
parameter can be indicated by two consecutive commas. 

< par am value> 



2.4.10 VALUE LISTS 



<value list> ss* C<value> C <sep><value>3 .. . ) 

A value list consists of a series of values separated by 
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2.4.10 VALUE LISTS 



spaces or commas and enclosed in parentheses. 



2.4.11 CONTINUATION 



< i nput 1 i ne> 



» <text><.,><EOL><text> 



Commands can be continued by placing an ellipsis at the end of 
the line. The first character of the continuation line replaces 
the first character of the ellipsis. The total number of 
characters must not exceed 150. Due to an Implementation 
I anguage I i ml t at 1 on> the maximum length of a line of lower case 
letters (ASCII 6/12 format) is 120. 
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3.0 ££M£EAL-D£i£EI£IiaM-a£-Cai}a£.>.Ui£ 



A CCDBG session must begin with a DEBUGCON) control statement 
that places the operating system in CC08G mode. It remains in 
CCD3G mode until the control statement DE8UG(QFF) is entered. 
When the operating system Is in CCDBG mode^ the CCDBG supervisory 
module Is loaded as part of the system response to a request for 
the load of an object program. Subsequent execution begins 
within the CCDBG module^ not the user program* and the following 
message appears at the terminal J 

CY8II-CC INTERACTIVE DEBUG 

The question mark is a prompting character Issued by CCDBG 
each time It is waiting for a response from the terminal. 

Once the CCDBG header line appears* the user should enter the 

CC08G commands that would set breakpoints and traps* specify 

output options* or preset any data values. A command of EXECUTE 

or GO starts execution of the object program. 

When any of the specified conditions occur* the condition is 
reported* the execution is suspended* and control passes to the 
user at the terminal. Diagnostics and trap and breakpoint 
reports are displayed with a preceding asterisk. 

During the time the user has control* CCDBG commands can be 

additional breakpoints and traps* and generally explore the 
behavior of the program. If necessary* the HELP command can be 
executed to learn about CCDBG commands* 

Program execution resumes at the location where it was 
suspended* or at a user specified location* Any abnormal program 
abort* as well as normal program termination* returns control to 

CC08G. 

Debugging of a p arti cul ar progr am ends when the QUIT command 
is entered* This command terminates CCDBG control* and other 
terminal operations can be performed. If any user program Is 
subsequently referenced In a load request* however* CC086 is 
again loaded and gains control, 
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CCDBG features are listed below* along with general 
information about them. 



3 . 1 £EQaEA!i«£ i^SaUIIQM^aQtilRQL 



Program execution halts whenever a user-defined breakpoint or 
trap condition occurs* Execution can be resumed at the point at 
which it was interrupted or at any other specified program 
location within the same procedure. 

An interrupt command provides a general stop-on-demand 
capability that can terminate infinite loops or excessive 
output. 



3,2 iiiaiL=aa.SQiiaa£-ii!iaoL-E£££R£Ma£-£A£AaiLiii 



Locations within a CYBIL-CC module can be referenced by 
variable names and line numbers if the module was compiled with 
the OEBUG option selected. Fields of records may be referenced 
using the same notation used in CY8IL-CC (including pointer 
notation) • Array elements may be referenced using a subscript 
only if the subscript is a constant of the same type as the array 
index. Variables and names used as constants are not allowed as 
subscr i pts. 



3 • 3 ll4QHIH£^L£M£.L^a£auaS£!i^«££4iyE£l 

jtcvciai jcacuic;:) iciactti^ t.u 

program registers are available. 

Program register values can be examined and changed. 

Step mode execution by trapping each Instruction prior to 
execution. 

Instruction-oriented trap definitions cause execution in 

interpret mode. Each time execution stops* the I* j and k 

operands* and the effective address of the current 
instruction can be displayed* 

After a write or read* the value can be displayed* and the 
value previously written or the prior contents of the X 
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register before a read can be displayed* The previous 
contents of the A register can also be displayed* 



3.^ aii££LAI^£l^£iaQl^a£M 



Program execution can be trapped when particular overlays are 
loaded* Details of the overlay structure and of the loaded 
overlays can be Indicated* An overlay qualifier can be used in 
specifying an address or module name* 



3*5 Q£fiy£S£i.SCi-EEQC£ayE£ 



A debugger SCL procedure consists of a sequence of CC08G 
commands and can foe given a procedure name# such that all 

commands in the sequence execute each time the procedure name is 
referenced* 

Similarly* a breakpoint or a trap can be defined with a CC08G 

SCL procedure that executes each time the specified event 

occurs* 



3.6 aQMaiiiaMAL.aQ!i!iAiiO-.£i£ayiiQM«£A£^aiLii]i: 

A SKIPIF command within a debugger SCL procedure allows some 
CC03G commands to execute only when particular program values or 
status variables exist* 

3.7 igiQ.mn^ 

\/eto mode gives the user veto power over each Individual 
command within a debugger SCL procedure that is otherwise 
executing automatically* 

3.8 ll££IiIIlQM_£IL£>C MAfilLIII 



Definitions of trapse breakpoints* and debugger SCL procedures 
can be saved on a file. This feature eliminates the need to 
re--enter long CC03G sequences In future sessions* 
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3 . 9 £fl£ail£ai!:lI/a£SIAEI^Ci£AaiLIII 

A CCD8G session can be checkpo i nted. The session may later be 
restarted nith the CCD8G environment intact. 



3.10 MAa!iilS-CA£AaiLIII 



A warning message is displayed prior to the execution of a 
command that would destroy existing definitions* or that might 
produce uncertain results. 



3.11 ££Qaa«MASlAaL£i 



Special identifiers can reference CCOBG variables containing 
information such as current program address* field length* number 
of breakpoints* traps or debugger SCL procedures defined. Ten 
scratchpad variables can be fully controlled by the user* 



3.12 iM£QEdAiia!ii^ay.i£yi 



Listings that can be obtained during a CCOBG session includes 

Load map Information 

Current CCD8G environment 

Currently defined CCD3S SCL procedures 

log of the remainder of the session to be written to a file for 
I at er pr i nt j ng. 



3.13 BiLE^CQadiAil} 



The HELP command can be used any time during a session to 
obtain a summary of information about CCD8G features* 
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4*0 iiaflis^aaai3AMaa 



The foHowIng sections describe the features of CC0B6 
commands. AH CCOBG commands adhere to the System Command 
Language (SCL) definition as specified in the NOS/180 Preliminary 
ERS. The description of the parameters denotes the positional 
order of the command parameters* 

4.1 a££AK£QlliIi-.Alia-ia4£S 

Breakpoints and traps provide a means for monitoring program 
execution. When a breakpoint location is reached* execution of 
the program is suspended* and CC08G gains control. For a trap* 
CC03G gains control when some specific condition occurs. In 
either case CCOBG commands may be processed* allowing a 
programmer to took at and change elements of the executing 
program. 

3oth traps and breakpoints may be established with "bodies". 
A body is a sequence of CCOBG commands that are executed 
automatically when the trap or breakpoint occurs. In this case* 
the user does not receive notification of the breakpoint or trap* 
nor does the user receive control unless a PAUSE command is 
executed as part of the body of the breakpoint or trap* 

The fact that a trap or breakpoint is being established with a 

SET^BREAKPOINT or SET^TRAP command. All subsequent commands* 
until a collect^end is encountered* constitute the body. These 
commands are checked for syntax errors when they are entered* but 
they are not executed until the breakpoint or trap condition 

occurs. 



4.1,1 SET_3R€AKP0IHT T S3 



This command sets a breakpoint in the user's program at a 
specified location* It may also start the definition of a body 
(set of CC03G commands between collect and col I ect_end). 
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^«0 CC03G COMMANDS 

4,l,l SET^BREAKPOIHT i SB 



set^br eaKpo i n t Caddr ess^expr 1 

Cmodu I e = <naine>lCover I ay« (<i nt eg€r> 
*<integer>) 1 Coffset*<integer>1 
Cfirst=<lnteger>3 Clast«<integ€r>3 
Cs tep3<i nteger>3 C<col I ectXeoiSO 
C<conimand.statemen tXeoU 5>3 ••• 
<col I ect_end>] 

addr ess^expr s The address specified by this parameter is known as 
the base address and may be specified in any of the 
following ways! 

line * |a<integer> 

Where integer Is a CY8II-CC line number generated by 
the compi I er • 

entrypoint J e = <na;Tie> 

Where name is an entry point Identifier. 
NOTE? automatic variables and parameters are not 
available until the procedure prolog is completed* 
This form is included primarily for use with COMPASS 
entry points. 

location * I oc«<i nteger > 

Where integer is an absolute address. 

If no keyword is specified in the order dependent 
format? line number will be assumed* 

module I mi CY3IL-CC compilation unit to which line or label 
applies. If it is not specified^ the default module is 
used. If address^expr is not specified* the base 
address is the beginning of the module. 

overlay t ovi i This specifies the overlay number In which the 

breakpoint is to be set. Default is to use the loaded 

overlays in the following orders l) overlay which Is 

currently being executed* 2) main overlay* 3) primary 
overlay* 4) secondary overlay. 

offset I OS A displacement which Is added to the base address to 
form the effective memory address. Default is zero. 

first » fs The number of times the breakpoint must be reached 
before it is honored. Default is 1. 

lasts The breakpoint will not be honored again after it has been 
reached this number of times. Oefaultis infinity. 
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4.0 CCD8G COMnANOS 
4,1*1 SET.BREAKPOINT J S 



step J s5 Frequency parameter. Breakpoint will be honored every 
step times it is reached. Default is !• 

collect « cJ Activates collect node to establish a body for this 
breakpoi n t* 

command^statement: CCDSG commands that make up the body of this 
breakpoint. 

collect_end J cei Terminates collect mode* 

Upon establishment of a breakpoint* a number is assigned. 
This breakpoint numbers #n> Is useful in referring to 
breakpoints* and is used in the breakpoint reporting message. 

yhen a breakpoint is reached and the frequency criteria are 
met* the breakpoint is honored. The message is? 

'^ B #n AT location 

where n %s the breakpoint number* and location defines the 
location as specified in the SET^BREAKPOINT command. After 
issuing the message* CCD8G is ready to accept new commands. 

Examples: SB 10 

Sets a breakpoint at line 10 of the default module. 

SB e=slmple offset^lO f*ll c 

DR b«4rPA5ce 

Sets a breakpoint 10 locations after entrypoint 
simple. It is honored the llth time It Is reached* 

honored^ register B4 is displayed and a pause is 

done. 



4.1.2 SET.TRAP J ST 



This command establishes a trap. It indicates the type of 

trap to be established and the scope of the trap* If the scope 

Is not specified* the condition is trapped anywhere in the 
program. 
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4.0 CCD8G COMHANDS 
4.1.2 SET^TRAP J ST 



set_trap J st type^Ktr ap_type> Cscope_expr3 

Cover f ay»C<l nteger>f < lnteger>)3 
Craodu le»<nafBe>3 Cproc«<name> 
C •<name>1 ••* 3 C<co I I ectXeol *» |> 
[<Gom(nand.statement><eol 2 j>3. •• 
<col 1 ect_end>3 

types Specifies condition s«hich will cause interruption of 
program execution. Trap_type must be one of the 
f ol I owing. 



QVERIAY 1 


OVL 




END J € 








ABORT I A 








INTERRUPT 


* 

4 


INT 


INSTRUCTION 


1 
1 


I 


LINE 








RJ 








XJ 








JUMP \ J 








READ 1 R 








WRITE J W 









NOTES If trap. type is OVERLAY or LIN£.» the keyword TYPE 
uust be specified^ since OVERLAY* OVL and LINE are also 
used as keywords In this command. 

scope. exprJ This specifies where the trap Is to apply. It is an 
address range which may be specified by any of the 
f 1 lowing: 

line * I «<i nteger>C<. .Xi nteger>3 

Where integer Is a CYBIL-CC line number generated by 

location I I dc*< I nteger>C<. .Xi n teger> 3 
Where integer is an absolute address. 

offset o = <i nteger>I<. .X integer > 3 

Where Integer is an address relative to a module. 

variable J var«<name> 

Where name is the identifier of the variable* This 
form is used for READ and WRITE type traps. NOTE? 
Dynamic variables are assigned only when the proc In 
which they are declared is active* Traps on dynamic 
variables should not remain established after the 
procedure completes* 
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If the order dependent format Is used and a keyword is 
not given* iine win be assumed. 

overlay \ ovis If trap_type is OVERLAY* this specifies which 
overlay number to trap. For any trap_type other than 
overlay* it may be necessary to specify which overlay 
the address range applies to* Default Is to use the 
loaded overlays in the following order? 1) overlay 
y^hich is currently executing* 2) main overlay* 3) 
primary overlay* 4) secondary overlay* 
MOTE J Overlay numbers default to decimal on input* 

module \ mi CYBIl-CC compilation unit to which scope^expr 
applies* If it Is not specified* the default module is 

used* 

proc • ps CYBIL-CC procedure name to which variable applies* 
Nested procedures may be referenced in the format 
procl*pr oc2*pr oc3* where proc3 is the desired 
procedure* If proc is not specified* the default proc 
i s used* 

collect J c5 Activates collect mode to establish a body for this 
trap* 

commandos tatements CCOBG commands that make up the body of this 
trap. 

collect_end » ceJ Terminates collect mode* 

Upon establishment of a trap* a number is assigned. This trap 
number* #n* is useful in referring to traps and is used in the 
trap message* A trap remains established for the remainder of 



)A\\BX\ the condition specified in an established trap is 
encountered* trap action occurs* The message to the user is? 

* T #n* type trap^message xx location 

Where n is the trap number* type Is the trap^type specified in 
the SET. TRAP command* trap^message is additional information 
depending on type* xx is AT or IN* and location identifies where 
the trap occurred* After issuing the message* CCOBS is ready to 
accept new commands* 

Examples J ST t*jump 1 = 30**70 
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Sets a trap on jumps between line 30 and line 70 of 
the current default module* 

ST t«wr i te var « test.resul t 

Sets a trap on writes into variable test_result* 

ST TYPE » LINE 

This example alloi^s you to step through your program 
executing one line at a time. 

ST TYPe«LIN€ LINe»120*.140 COLLECT 

CV #V1 #P-1 
OV #V1 F«ADR 
COLLECT^ENO 

This example sets a trap on the execution of any of 
the lines specified in the scope range (120-140)* and 
displays the line number that was trapped. 

ST type* I i ne c 
CV ivl #p-l 
DV #vl f=adr 

GO 
ce 

This example creates a trace* displaying each tine 
number as it is executed* 

4.1.3 DISPLAY_8REAI<P0INT J D8 



This command lists all breakpoints In a program Cor part of a 
program) or If a specific breakpoint number or a specific 
location is given the body of that breakpoint is displayed* 

di sp I ay^breakpoint \ db C address_expr 3 

i:b«<lnteger>C<»»><integer>3 J 

C < j nteger>C<*»>< i nteger>1 

C <sep><integer>C <• .Xi nteger>33« . • )1 

Cof fset-<jnteger>3 

Cover I ay*{ <integer># <i nteger> ) 3 

Cmodul e*<name>3 

address^expr? Sped f i es the location or range of locations to 
display breakpoints from. It must be one of the 
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f 1 1 w i n g I 

line I l*<integer>C<..><integer>l 

Where integer is a CY8IL~CC line number generated by 
the compt I er* 

location I I oc«< i nteger>C<« •>< i nteger> 3 
Where integer is an absolute address. 

entrypoint I e*<nafne> 

Where name is an entry point identifier* 

If the order dependent format is used and a keyword is 
not given* line will be assumed. 

bJ The breakpoint number assigned when the breakpoint was 
estabf ished. 

offset I 0* A displacement that is added to the base address to 
form the effective memory address. Default Is zero* 

overlay ' ovi: This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays In the following orders 1) 
overlay which is currently executing* 2) main overlayf 
3) primary overlay* 4) secondary overlay* 

module 1 ms The CY8Il~CC compi I at I on un i t to which the line or 
offset parameter applies* If module is not specified* 
the default module is used. 

Ex amp I es J 08 3 

Displays the body of breakpoint nuffiber 3s 

03 over I ay«{ I* 3 ) 

Lists all the breakpoints In overlay number (1*31. 



4.1.4 OISPIAY^TRAP J DT 



This command lists traps In al 1 or part of the program? or* If 
a specific trap number or specific location Is given* the body of 
that trap is listed. If traps from a range of locations are 
being listed* the user may have all types of traps listed* or may 
list only those traps of a specified type. 
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display_trap t dt t type«<trap.type> 1 Cscope_expr3 

Ct-<integ8r>C<.«><integer>l t 
(<integer>C<««><integer>1 
C<sep><lnteger>C<»»><integer>3]».»)1 
C V e r I a y * l< I n t e g er > * < I n t e g er > ) 1 
Cmodui e»<name>] C proca<narae> 
i .<name>3 • • • 1 

type: Specifies type of trap to be displayed* Trap_type must be 
one of the followingJ 

OVERLAY t QVL 

END \ E 

ABORT ; A 

INTERRUPT J INT 

INSTRUCTION J I 

LINE 

RJ 

XJ 

JUHP \ J 

READ J R 

WRITE J W 

If no type is specified* alt types are displayed. 

NOTE: If trap. type is OVERLAY or LINE* the keyword TYPE 
must be specified* since OVERLAY* OVL and LINE are also 
used as keywords in this command* 

scope.exprs Specifies the location or range of locations to 
display traps from* It must be one of the following: 



iine J 1 =<i nteger >C<* «><i nteger>3 

1,1 U ~ — ~ J -»*.._ ^ ^ 

n 1 1 1: I c I 1 1 u c v| c 

the com pi I er* 



1 1 u c v| c < t :s <a V » u i. i. — u V, line < i u tti u c i y e n c i a u c u u y 



location 1 I oca<i nteger>C<* .Xi nteger>1 
Where integer is an absolute address* 

offset * o«<integer>C<* .><integer>3 

)4here integer is an address relative to a module* 

variable 1 var*<name> 

Sphere narae Is the identifier of the variable* 

If the order dependent format is used and no keyword Is 
given* line will be assumed* 
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t! The trap number assigned when the trap was established* 

overlay I ovi s This parameter may be necessary to specify which 
overlay the address range applies to. Default is to 
use the loaded overlays in the following 
orders 1) overlay which is currently executing* 2> 
main overlay* 3) primary overlay* 4J secondary 
over! ay, 
NOTE! Overlay numbers default to decimal on Input. 

module 5 ms The CY3IL-CC compilation unit to which the line or 
offset parameter applies* If It Is not specified* the 
default module is used* 

proc Ips The CY3IL-CC procedure name to which variable applies* 
If not specified* the default proc is used* Nested 
procs may be referenced in the format 
procl.pr oc2 .procS* where proc3 is the desired 
procedure* 

Exampless DT m=my_mod 

Lists all traps of any type In module my_mod* 

DT type«rj 

Lists all RJ traps set in the program* 



4*1*5 SAVE.BREAKPOIHT J SAVEB 



This command saves the breakpoint definition on a local file* 

cithSr specific brS^lkpGintS Of ««! urcakpGnntS ill the pfOyranTi af 

part of the program may be saved* If the breakpoint has a body* 
it will also be saved* If no qualifying parameters are 
specified* all breakpoints will be saved* 



save_breakpol nt J saveb 



file \ f J The name of 
def I ni ti ons on* 



ftle=<name> Cscope_expr1 

£b«<integer>t <* ♦><! nteger>3 I 

{<i n teger>C<* •><integer>l 

C<sep><integer>C<**><integer>13*«» n 

Cof f set»<integer>3 

Cover I ay«{<i nteger>* <i nteger> ) J 

Cmodul e«<name>3 

a local file to write breakpoint 
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scope.exprs This specifies the location or range of locations to 
save breakpoints from. It must be one of the 
f 1 lowing: 

line J l=<i nteger>C<« .Xin teger>3 

Where integer is a CY8IL-CC line number generated by 
the compi I er • 

location J I oc*<i nteger >C< • •>< i n teger >3 
Where integer is an absolute address. 

entrypoint I e=<naiiie> 

Where name is an entry point identifier. 

If the order dependent format is used and no keyword is 
given> line will be assumed. 

bs The breakpoint number assigned when the breakpoint was 
estabi ished. 

offset J 0! A displacement that is added to the base address to 
form the effective memory address. Default is zero. 

overlay I ovM This parameter may be necessary to specify which 
overlay the address range applies to. Default Is to 
use the loaded overlays in the following orders i) 
overlay which is currently executing* 2) main overlay^ 
3) primary overlay* 4) seconder y over I ay * 

module \ ms The CYSIi-CC compilation unit to which line or offset 
apply. If It is not specified* the default module is 

used. 



Saves breakpoints number 2 and number 3 on local file 

BfFILE. 

SA\/€S*bps*10..40***{l*3)*xyzl2 

Saves on file 8PS* a I I br eakpo i nts In lines 10 to 40 
which are in module xyzl2 on overlay Cl#3). 
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4.1,& SAVE^TRAP J SAVET 



This command saves the trap definition on a local file. 
Either specific traps or all traps in the program or part of the 
program may be saved. All traps may be savedy or just one type 
of trap may be saved. If a trap has a body* it will also be 
saved. If no trap number* type* or scope^expr is specified* all 
traps will be saved. 

save^trap i savet f i I e*<name>C type«<tr ap_type>] 

Cscope_expr3 

Ct*<integer>C<..><integer>3 I 
(<integer>C<».><integer>] 
C<sep>< integer>C<*.><integer>33...)1 
Cover I ay-(<lnteger>*<integer>)1 
Cmodu ie«<nanf}e>] Cproc*<name> 
C . <name>1 • • . 1 

file J ft The local file to write trap definitions to. 

types Specifies the type of trap to be saved. Trap_type must be 
one of the following. 

OVERLAY J OVL 

END I £ 

ABORT \ A 

INTERRUPT ; INT 

INSTRUCTION \ I 

LINE 

RJ 

XJ 

o c A n » o 

I\ 4- « 1/ 1 )N 

WRITE \ W 

If no type is specified* all types are saved. 

HQlEi If trap.type is OVERLAY or LINE* the keyword TYPE 
must be specified* since OVERLAY* OVL and LINE stq also 
used as keywords In this command. 

scope_exprs This specifies the location or range of locations to 
save traps from. It must be one of the followings 

line * I =<i nteger >£<. ♦><integer>3 

Where integer is a CYBIL-CC line number generated by 
the compi I er. 
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location 5 I oc«< i nteger>C<« *>< I nteger>3 
Where integer is an absolute address* 

offset \ o-<i nteger>£ <••><! nteger>3 

Where integer is an address relative to the beginning 
of a module* 



variable S ¥ar«<nanse> 

Where name Is the identifier of the variable* 
form is used for READ and WRITE traps* 



This 



If the order dependent format is used and no keyword is 
given* line »<i I I be assumed* 

t! The trap number assigned when the trap was established* 

overlay I ovls This parameter may be necessary to specify which 
overlay the address range applies to* Default Is to 
use the loaded overlays in the following orders 1) 
overlay currently executing* 2) main overlay* 3) 
primary overlay* 4) secondary overlay* 
NOTEJ Overlay numbers default to decimal on Input* 

module I mi The CYBIL-CC compilation unit to which the line or 
offset parameter applies* If It Is not specified* the 
default module is used* 

proc * pJ The CY3IL~CC procedure name to which var applies* If 
it IS not specified* the default proc is used* Nested 
procedures may be referenced in the format 
procl* proc2*proc3* where proc3 Is the desired 
procedure* 



Save a II traps of type write. 

SAVET modu I e= latest 

Saves all traps In module latest* 



4*1*? CtEAR_3R£AKPQIHT T C8 



This command clears specific breakpoints* or all breakpoints 
in the program or part of the program* If no parameters are 
specified* a warning message will be Issued* If the user accepts 
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the warning* all breakpoints will be cleared* 



c I ear_breakpo i nt J cb 



Cscope_exprl 

Cb=<integer>C<*«><integer>3 5 

{<integer>C<«.><integer>] 

C<sep><integer>C<««><integer>31«.,)3 

[offset =<integer> 3 

Cover(ay«(<i nteger>f <integer>)3 

Ctnodul e»<name>3 



SGOpe.expr! This specifies the location or range of locations to 
clear breakpoints from* It must be one of the 
f 1 I w i n g 5 

line J I 3<i nteger>C<» .Xi nteger>3 

Where integer is a CYSIL-CC line number generated by 
thecofflpiler* 

location J I oc«<i nteger>C <• «><l nteger>3 
Where integer is an absolute address. 

entrypoint J e3<naine> 

Where name is an entry point identifier. 

If the order dependent format Is used and no keyword Is 
given> line will be assumed. 

bs The breakpoint number assigned when the breakpoint was 
est ab I ished. 



offset 






oJ A displacement that is added to the base address to 
form the effective memory address. Default Is zero. 

I V 1 • I M i 5 P 5 r 3 ill S I. c r io 3 y u c n 6 C 6 5 S ai r y c S P c u » t y «i ri I C It 

overlay the address range applies to* Default Is to 

use the loaded overlays in the following order? 1) 

overlay currently executing* 2) main overlay* 3J 
primary overlay* 41 secondary overlay. 

module * ms The CYBIL-CC compilation unit to which line or offset 
and proc apply. If it is not specified* the default 
module Is used. 

Ex amp I ess C8 b«l 

Clears breakpoint number I. 

CB lineal? offset«4 

COHPANY PRIVATE 



COC - AOVANCEO SYSTEliS OEVEIOPHENT 
ERS for CYBIL-CC Interactive Debugger 



4-14 

09/29/80 
REVS 



4.0 CC08G COMHANDS 

4,1.7 CLEAR. BREAKPOINT i C8 



Clears breakpoint at 4 words past the word containing 
the first instruction generated by the statement at 
line 17. 



4.1.8 CLEAR.TRAP J CT 



This coifln^and clears specified traps or all traps in the 
program or part of the program. AM types of traps may be 
cleared or one type may be specified. If no parameters are 
specif ied> a warning message will be issued. If the user accepts 
the warning^ all traps will be cleared. 



cl ear_tr ap 



ct C type = <trap_type>Kscope_expr 3 

£ t«<in teger>C<*.><integer>l J 
C<integer>C<..><integer>3 
C<s9P><integer>t<..><integer>31...)l 
Co ver 1 ay*{< i nteger >> < lnteger>) 3 
Cmodui e-<name>3 Cproc«<name> 
C. <name>3**» 3 

typeJ Specifies type of trap to be cleared. Trap_type must be 
one of the following. 

OVERLAY J OVL 

END \ E 

A80RT : A 

INTERRUPT ? INT 

INSTRUCTION J I 

LINE 

RJ 

XJ 

REAO J R 
WRITE J W 

If no type is specified* ail types are cleared. 

NOTES If trap.type is OVERLAY or LINE* the keyword TYPE 
must be specified* since OVERLAY* OVL and LINE are also 
used as keywords in this command. 

scope_exprs This specifies the location or range of locations to 
clear traps from. It must be one of the following? 

line I I *<l nteger>E<. •><integer>3 

Where integer is a CY3IL~CC line number generated by 

COMPANY PRIVATE 



CDC - AOVAHCED SrSTE^S DEVELOPMENT 
ERS for CY8IL-CC Interactive Debugger 



4-1 5 

09/29/80 
REVS D 



4*0 CC03G COMMANDS 
4a. 8 CLEAR.TRAP J CT 



the compi I er ♦ 

location I i oc=<i nteger >C<* •>< i n teger> 3 
Where integer is an absolute address* 

offset *t o = <i nteger>£<« .Xi nteger>3 

Where integer is an address relative to a module. 

variable J var»<naffle> 

Where name is the Identifier of the variable* This 
form is used for READ and WRITE type traps. 

If the order dependent format is used and no keyword is 
given* line ^i I 1 be assufned. 

tJ The trap number assigned when the trap was established. 

overlay ] oviJ This parameter may be necessary to specify which 
overlay the address range applies to» Default is to 
use the loaded overlays In the following order? 1) 
overlay currently executing* 2) main overlay* 3) 
primary overlay* 4) secondary overlay. 
NOTE? Overlay numbers default to decimal on input. 

module * m: The Cf3It-CC compilation unit to which the line* 
offset* or proc parameter applies* If it is not 
specified* the default module is used. 

proc 1 pi The CY8II-CC procedure name to which variable applies* 
If it is not specified* the default proc Is used. 
Nested procs may be referenced in the format 
pr ocl.pr oc2*proc3* where proc3 is the desired 

procedure. 

Examples? CT type«overlay 

Clears ail traps of type overlay in the program. 

CT t=instruction I oc»1653( 8) . .1700{ 8) 

Clears any traps of type INSTRUCTION In the address 
range 1653 to 1700. 
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4.1.9 SET^IHTERPRET J SI 

Allovis the CCDBG user to explicitly control the use of 
interpret aiode. Interpret mode is turned on by the SET.INTERPRET 
command. 

Interpret mode Is also turned on when any trap of types RJ# 
XJ, JUMP, WRITE, READ, or INSTRUCTION are established. 

If a CLEAR_INT£RPR£T command is subsequently Issued, the traps 
are made inoperative until a SI command Is Issued, when they 
again become operative. 

4.1.10 CLEAR.IHTERPRET I CI 
Clears Interpret mode* 

4.2.1 OISPLAY^VARIABLE \ DV 

This command displays the values of CYBIl-CC Identifiers in a 
format corresponding to their program defined type, or in a 
memory format specified by the user. Fields of records may be 
referenced using the same notation used in CYBIL-CC lincluding 
pointer notation). Array elements may be referenced using a 
Sutiscript ojily if the Suuscrlpt Is a coristarit oi t^uB same type as 
the array index. Variables are not allowed as subscripts. 

di sp I ay_var i abl e { dv Cvar=<name>l 

Cformat = oct I dec « hex3Cmodule'«<name>3 
Cpr oc«<name>3 C •<name>1 •• * 3 

variable J vars Name of the program variable to display. It will 

be displayed in a format corresponding to its program 

defined type. These types and corresponding formats 
ares 

integer - signed decimal Integer 
character - asci i character enclosed in single 
quotes* 
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4.2.1 DISPIAY.VARIABLE J OV 



enc I osed in s ing I e 



ordinal - name composed of ascii characters 

boolean - true or false 

pointer - octal digits 

set - eacli element is displayed as listed above# 

depending on its defined type, 
string - ascii characters encio 

quotes 
sequence - octal digits 
array - each item is displayed as above> 

depending on Its defined type, 
record - each field Is displayed as above 

depending on its defined type. 

If no variable name is sped fied# a list of variables 
will be displayed. What variables are displayed 
depends upon which other parameters are specified. If 
^ ar is not specif ied> and proc i s» then all variables 
local to the specified proc are displayed. If only 
fuodule IS specified then only variables at the module 
level are displayed. If no parameters are specif ied# 
local symbols for the current default are displayed. 
This may be either procedure level or module level 
depending on the current default value. 



format I f* Specifies 
var i able. One 



the format In 
of these threes 



which to display the 



module 



proc 



octs Octal digits followed by C8) 

dec: Signed decimal integer 

hex? Hexadecimal digits followed by (lb) 

If this parameter is specified* it over ides the program 
defined type format. 

ms The CYSIL-CC compilation unit to which var applies. 
If it is not specified* the default module Is used. 

pi The CY8Ii-CC procedure name to which var applies. If 
it is not specified* the default proc is used. Nested 
procedures may be referenced in the format 

procl.pr oc2.proc3* where proc3 Is the desired 
procedur e. 

Examples DV yar»l pr oc*calcuf ate_subscr i pt 

Displays variable I in format corresponding to its 
program defined type. Variable I is in proc 
a I c u i at e_s ub s c r I p t . 
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4,2.2 CHANG£_VARIA8L£ I CV 



This command changes the memory locations at the address of 
the CYSIL-CC identifier. Subscripted references and field 
references may be made in the same way as In DISPLAY^VARIABIE* 

change_varl ab I e 1 cv vara<name> value«<expr> 

Cmodul e«<name>l Cproc=<name> 
I • <name>l • • * 3 

variable * var: Name of the user variable to change* 

value * vs The dectnialf octal or ascli value to be stored at the 
specified variable. The format of the value must match 
the type of the variable (see list under 

0« sp I ay_Var i abl e) • For boolean variables > only the 
values *true* and 'false* are valid* For a set 
variable* the value specifies an element of the set 
that is to be added to or deleted from the set, 

module I mJ The CY9IL-CC compilation unit to i^hich var applies. 
If it is not specified* the default module is used, 

proc \ pi The CY8IL-CC procedure name to which var applies. If 

it is not specified* the default proc Is used. Nested 

procedures may be referenced in the format 

pr ocl, pr oc2,proc3 f yihere proc3 is the desired 
pro cedur e. 

Examples CV var«x_string value«»zero« 

Changes variable x.string to the string zero, x^string 

The DISPLAY. HEHORY* FORWARD and BACKWARD commands maintain a 
single default memory address and a default format. After being 
set by a OH command* these values are used by FORWARD and 
BACKWARD, This allows other commands to be used between any 
memory display commands without losing the position or format of 
the memory being displayed. The memory address and format are 
updated by each FORWARD* BACKWARD or OH command. Specifying a 
format type on a FORWARD or BACKWARD command means that format 
wi I I be the default until a new format is specified, 
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4. 3,1 DISPLAY. MEMORY \ DM 



^•3,1 DISPLAY. MEMORY \ DM 



This cominand displays the contents of a specified number of 
words beginning at a specified address. 

di spl ay.memor y » di^ <address_expr> 

Cforinat«oct J dec J adr J hexl 
Cnuml ocs«<integer>l 
Coffset = <integer>Hniodule«<name>1 
Cindi recti 

address.expr: The address specified by this parameter is known as 
the base address* Any one of the following forms fuay 
be used. 

location * I oc«<i n teger> 

Where integer is an absolute address* 

line » I « < i n t e g e r > 

Hhere integer is a CYBIL-CC line number generated by 
the compiler* 

ecs « <integer> 

Where integer is an ECS address* 

entrypoint ' e-<nanie> 

Where name is an entry point Identifier* 

If the order dependent format is used and no keyword is 
given* location Nil 1 1 be assumed* 

format J fs Format of the memory display* It must be one of the 

f O I \ owing- 

Oct: Octal digits followed by (8) 

deci Signed decimal integer 

adr! Lower 13 bits are displayed as an address 

hext Hexadecimal digits followed by (16) 

Default format is oct* 

numlocs I ni This specifies the number of memory locations to be 
referenced. Default is one* 

offset r OS A displacement which is added to the base address to 
form the effective memory address* Default is zero* 
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4,0 CCD3G COMMANDS 

4.3 •! OISPLAY.MEMORY 5 OM 



module J ms CYBIL-CC compi 1 at i on uni t to which line or offset 
applies. If it is not specified* the default module is 
used. 

indirect J is This specifies that the display is to be at the 
memory location addressed by the contents of the base 
address. 

Example! DM e«cdt a^of f se t=4f f «oc t» n»10 

Displays ten words of memory in octal digits beginning 
four words after entrypoint cdta* 



4,3.2 FORWARD I FW 



This command continues the memory display forward from the 

last 0M> FORWARD or BACKWARD command. Displays memory starting 

with the word following the last word displayed by the previous 

command. 



forward 



numi ocs 



format 



fw 



nu m I ocs«< Integer > 

Cformat«oct * dec I adr S hex 3 



t n: Specifies the number of memory locations to be 

r ef erenced. 

f: Format of the memory display. It must be one of the 
f 1 I w i n g J 

octs Octal digits followed by C8) 

decs Signed decimal integer 

adfi Oisplays iower 16 bits as an address 

hexs Hexadecimal digits followed by C16) 

Default value for format is to continue in the same 
format as the previous dl sp I ay.memor yt forward* or 
backward command* 



Examples FORWARD 6 



Oisplays the next 6 words of memory In the same format 
as the previous DISPLAY.MEHQRY, FORWARD or BACKWARD. 
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4.0 ccdsg commands 
4,3,3 backward i bw 



4.3,3 BACKWARD J BW 



This command continues the memory display with the section of 
memory preceding the current display memory location. It 

displays memory from the word preceding the first word displayed 
by the previous command back n locations. 



bacKwar d 



numi ocs 



format 



bM 



numlocs=<integer> 
Cformat«oct J dec 



adr 



hex 3 



* ni Specifies the number of memory locations to be 
referenced, 

fj Format of the memory display. It must be one of the 
foil owings 

octs Octal digits followed by (8) 

dec: Signed decimal integer 

adr: Displays tower 18 bits as an address 

hex: Hexadecimal digits followed by (16) 

Default value for format is to continue in the same 
format as the previous dl sp I ay^memor y» forward* or 

backward command. 



Example: BACKWARD 4»oct 



Displays the four preceding words of memory 
format. 



in octal 



4.3,4 CHANGE. MEMORY J CM 



This command changes the contents of the specified memory 
locations* 



change_memory * cm 



<address_expr> 

f:module*<name>3 Coffset«<integer>1 
val ue«<expr> CnumI ocs«<i nteger>1 
Clndi recti 



addr ess.expr : The address specified by this parameter is known as 
the base address. Any one of the following forms may 
be used. 



location I I oc = <i nteger > 
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4.0 CCD8G COHIiANOS 
4*3,4 CHANGE..MEMQRY 5 CM 



Where integer is an absolute address* 

line I I = < i n t e g e r > 

Where Integer is a CY8II-CC line number generated by 
the compi I er* 

entrypoint I e=<name> 

Where name is an entry point identifier. 

ecs«<int€ger> 

Where integer is an ECS address* 

If the order dependent format is used and no keyword is 
given^ location is assumed* 

module J m: The CY3IL-CC compiiation unit to «hich line applies* 

offset 5 oJ A displacement which is added to the base address to 
form the effective memory address* Default is zero* 

value J vs The octal* decimal* hexadecimal or ascii value which 
is to be stored at the memory address specified* 

numiocs J ns This specifies the number of memory locations to be 
changed. Default is one* 

indirect # i? This specifies that the location to be changed is 
the memory location addressed by the contents of the 
base address* 

Examples CM loc=6270<8) v*1493 

Stores 1493 (note default base is decimal I in octal 



4*3*5 DISPLAY. REGISTERS I OR 



This command displays the contents of the machine registers* 

di spi ay.r egi sters I dr Cp * fl J £a J b J x»C<i n teg er>1 11 

Cformat«oct ' dec I adr J hexl 
Cindi recti 

p I fl J a r b r x3 This specifies which type of register is to 
be displayed* The number for a# b* or x# indicates 
which register number to display* If no register 
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4.0 CC03G COMMANDS 

4»3.5 OISPLAY.REGISTeRS \ OR 



number is specified* all of the specified type will be 
displayed* If the parameter is omitted* all 24 A* 8* 
and X registers will be displayed* 



format 



indl rect 



f; Format of the register display* It must be one of 
t h e f II w i n g s 

octs Octal digits followed by C8) 

decs Signed decimal integer 

adrJ Displays the loi^er 18 bits as an address 

hexs Hexadecimal digits followed by (16) 

Default value of format Is octal for a> bf and x 
registers* and address for p and fl registers* 

• i! This specifies* if quoted* that the display is to 

be at the memory location addressed by the contents of 
the r egi s ter. 



Example: OR b 

Displays all b registers in octal format* 

4.3*6 CHANSe^REGISTERS \ CR 

This command changes the contents of the machine registers 



change_r egi sters \ cr 



a » b J x=<integer> 
value=<expr> £ indl recti 



a J b \ xs This specifies which type of register Is to be 

j^ j^ ^^ ^^ *-• -% y4 

be changed* 



i(»s jrjuSgGr 3p£Ci«i£3 uiiS rcgis^.sr numucr uO 



value 4 v2 This is the octal* decimal* hexadecimal or ascil value 
to be stored in the register* 

Indirect I is This specifies* If quoted* that the value is to be 
stored at the memory location addressed by the contents 
of the register* 

Example? CR x»6 v=1236{8) 

Places the value 1236 (octal) in register x6* 
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4.4 a£iys££E-S£L-£aQ£mya£a 

A debugger SCL procedure is a named sequence of CCD8G commands 
that is established within the CC08G environment. Any desired 
CC03G command sequence can be established as a debuger SCL 
procedure. Procedures can be invoked either from within some 
other procedure or from the terminal when In interactive command 
input mode* by issuing a READ command referencing the name of the 
defined procedure. 



4.4.1 SET^PRQCEOURE I SP 



This command establishes a debugger SCL procedure. 

se t^procedure ' sp pr ocedure»<name> C<coi I ectXeo I ! 5> 

C<command_st at ementXeo I » |>3.. • 3 
<col I ect_end> 

procedure « prJ The identifier assigned to this sequence of CCD8G 

c ommands » 

collect \ at Activates collect mode. This parameter is not 
necessary to establish a procedure* but is included in 
the syntax for compatibility with SET^TRAP and 

SET^BREAKPOINT commands. 

command_statements J CC08G commands which make up the body of the 
procedure. They are checked for syntax but not 
executed at this time. 

-.^I»^^4. ^«-4 • «^« X-K-.«,}^«-«.-^~ :it«^4. ™.^-Ji« -rut— _ 4. ;_ 

r equi red* 

Examples SET. PROCEDURE procedur e*newi d 5 OR b*5| DV var^xldv y| 

PA; c e 

Creates a procedure named newid which contains several 
commands. 



4.4.2 OISPIAY.PROCEDURE I OP 



This command displays the commands that make up the specified 
procedure. If no procedure identifier is specified* the names of 
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4.0 CC03G COMMANOS 

4,4,2 OISPLAY.PRQCEDURE t OP 



ail existing debugger SCI procedures are displayed* 

di spl ay_procedure I dp Cprocedure«<name> * 

<<nafne>C<sep><name>3«*.) ] 

procedure « pr? The identifier of the procedure to be displayed* 
as specified in the SET_PROCEDUR£ command. 

ExampleJ OP procedur e^ne wi d 

Displays the debugger SCL procedure named newid* 

4. 4.3 SAVE.PRQCEDURE I SAVEP 

This command copies specified procedure definitions to a local 
file. If no procedures are specif led* all debugger SCL 

procedures are copied to the file. 

save_procedur e * sayep fHe=<name> Cprocedur e«<name> • 

C<name>E<sep><name>]**. ) 3 

file I fs The name of the file the procedure Is to be saved on. 

procedure J pn The identifier of the group to be saved* 

Example: SAVEP procedure«newi d f«saveld 

Saves procedure named newid on file saveld* 

4.4.4 CLEAR.PROCEDURE i C? 



This command removes specified debugger SCI procedure 
definitions* If no procedure Is specified* a warning message Is 
issued* and if the user accepts the warning* all debugger SCL 
procedures are cleared. 



cl ear _proce dure * cp 



Cprocedur e«<name> I 

< <name>C <sep><n ame>1*.* ) J 



procedure t pri The identifier of the procedure to clear* as 
specified on the S£T_PRQCEDURE command* 

Examplei CP procedur e^newi d 
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4,4.4 CLEAR. PROCEDURE 1 CP 

Clears debugger SCL procedure newid. 
4.5 ll£2y£S£R.S£L-.PRQC£2yS£.aQll!14!iai 

A procedure is a set of CCDBG commands established as a 
debugger SCL procedure* Once initiated* the commands in a 
procedure execute automatically* 

Any CCD3G command may be used in a procedure* Most of the 
following commands* however* are particularly designed for use In 
a procedure* 

4*5*1 PAUSE I PA 

This command temporarily suspends the automatic execution of 
the current CC03G procedure and enters interactive mode* allowing 
CCD8G commands to be entered from the terminal. 

On the occurrence of the first PAUSE command in a procedure 
body of a trap or breakpoint* the appropriate trap or breakpoint 
report is issued prior to entering interactive mode* 

pause J pa C text** C<asct I >3 • * •• 1 

text 1 t! Message text to be issued when pause is executed. The 
text may be any string of characters* It is delimited 
by a pair of apostrophes C')* Apostrophes within the 
text are Indicated by two consecutive occurrences of 
the character* 

Examples PAUSE text=»x3 Is new value of I* 
4.5.2 MESSAGE t ME 



This command issues a designated message to the users terminal 
during a procedure execution* 

message I me C text=« Kasci i>3 • • .'1 

text ! ts Message text to be issued when the command Is 
executed* The text may be any string of characters. 
It Is delimited by a pair of apostrophes (')• 
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4.0 CCD8G COMMANDS 
4,5*2 MESSAGE I ME 



Apostrophes within the text are indicated by two 
consecutive occurrences of the character* 

Example: MESSAGE 'Variable XYZ has been modified* 



4.5.3 GO 



This command causes an exit from the current debugger SCI 
procedure or interactive mode and a resumption of suspended 
processing. The current debugger SCL procedure may have been 
invoked by a read* in iihich case the processing wi H be resumed 
with the statement foHowing the read. 

If the GO command is issued from a breakpoint or trap body> 
program execution is resumed. In this last caseji GO is identical 
to the Execute command. Resumption of program execution can be 
specified via the optional address parameter. 



go 



Caddress_expr1Coffset«<integer>3 



addr ess_exprs Address at i^hlch execution is to resume* It is not 
possible to resume execution In a different module or 
procedure. Address. expr may be any of the foliowingJ 

line * I » < I n t e g e r > 

^here integer is the CY6IL-CC line number generated 
by the compiler. 

location J I oc«< i nteger> 

Where integer is an absolute address* 

^here name is an entry point identifier* 

If no keyword is given for address_expr» line will be 

assumed* 

offset 5 0? A displacement added to the base address specified by 
addr ess.expr* 

Examples GO line- 42 offseta«3 
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4.0 CCOBG COMMANDS 
4.5*4 SKIPIF ; S 



4.5.4 SKIPIF J S 



This command conditionally skips the following command when 
the specified relation is satisfied. 



s k i p I f I s 



<y alue_l><rel ati onXva I ue_2> 



value^l * vlJ An integer expression. It may Include CC08G 
variables* but not program variables. 

relations One of the following: 

« Equal 

<> Not equal 

< Less than 

<= Less than or equal 

>» Greater than or equal 

> Greater than 

value_2 J v2J An integer expression. It may Include CCOBG 

variables* but not program variables. 

Example: SKIPIF #V1 < 20 

Skips next command if the value of CCDBG variable fVl 
is I ess than 20. 



4.5.5 LABEL I LA 

This command defines an identifier for the location in the 

Labels are local to the procedure In which they occur. No 
check is made for duplicate labels. 

label * la name«<name> 

name I n? Identifier to be used for this location. 

Examples LABEL n»blOI3 

Establishes label S10L3 at the current location in the 
procedure • 
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4.5.6 GOTO 

This coraiaand transfers control to the specified label within a 
procedure. Control can be transferred either forwards or 
backwards* Search Is forwards end around* until the first 
occurrence of the label is found. 

goto I abel «<nafne> 

label J la! Identifier of location to which control Is 
transfer r ed • 

Example? GOTO blOI3 

Transfers control to the location of label 810L3 

4.5.7 READ \ R 

This command is used in three different ways? 

1) To process CC03G commands stored or modified by some facility 
not provided by CCDBG itself {e.g.* the editor). 

21 To reconstitute breakpoint* trap* and debugger SCi procedure 
definitions previously SAVEd on a file* 

3) To invoke a debugger SCt procedure. 

read J r file « procedure « <name> 

fli<» i fs NaJT!? of file containing cojsniands to be Gxecuted. 

procedure I prs Name of procedure to be executed. 

Examples: READ fabpfile 

Re-establishes breakpoint definitions saved on 

3PFILE. 

READ pr ocedure=newi d 

Initiates processing of procedure NEWIO. 
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4 • 6 AaQiiiaiiAL.iiii£SA(iiiii£-iiaa£-cafliiAMfis 



4*6,1 EXECUTE } EX 



This cosnmand starts or resumes program execution. Program 
execution is initiated at the next instruction^ or at the user 
specified address. This command differs from the GO command when 
there are higher levels of CC08G commands. GO transfers control 
to the next higher level of CC08G commands* EXECUTE bypasses all 
CCOBG commands to resume program execution* 

execute * ex C address_expr 3 C of fset«<l nteger>1 

addr ess^exprs An address at which execution is to resume* It is 
not possible to resume execution In another module or 
procedure* It may be any of the following? 

line *, I = < i n t e g e r > 

Where integer is the CYBIL-CC line number generated 
by the comp J 1 er • 

location J I oc«< i nteger> 

Where integer is an absolute address* 

entrypoint » e - <name> 

"ilhere name Is an entry point identifier* 

If no keyword is given for address^expr j» line will be 

assumed* 

Example: EX 146 

Resume execution at line 146 relative to the current 
executing module. 



4,6*2 TRACE8ACK J T8 



This command produces a list of CYBIL~CC procedure names> 
beginning with the currently executing CYBIL-CC procedure and 
moving backward through successive levels* 
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4.0 CCD8G COMMANDS 
4.6,2 TRACEBACK ! TB 



traceback J tb 



[entrypolnt«<name>3 



entrypoint , as If a non-CYBIl-CC routine has multiple 
entrypolnts* this parameter specifies at which 
entrypoint to start the traceback. 



£xainpJe5 IB 



lists all calls beginning with the most recent and 
going backward as far as possible* 



4,6.3 MOVE I n 



This command moves values from one address range to some other 
address range or location. The action taken depends on whether 
either the source or destination parameter is a range 
specification. 

If the source or destination is a range spec If i cat i on# the 
nymlocs parameter Is ignored even if present and enough words are 
moyed from the source to fill the destination range. If the 
source range is smaller than the destination ranges the words are 
moved repeatedly until the destination range is filled* If the 
source range is larger* only as many words as are needed are 
moved. 

If neither the source nor destination Is a range 
specification^ the numlocs parameter determines the number of 
words to move. 



move J m 



source^expr des t i nat I on^expr 



source^exprs Address or address range expression from which to 
move values. Hust have one of the following forms J 

source^iine » sl=<integer>£<..><integer>3 

yhere integer is a CY8Il~CC line number generated by 
the com pi I er * 

sour ce_of fset I so*< i nteger>C<. . ><i nteger>1 

Where integer is an address relative to a module. 

sour ce_l ocati on I si oc*<i nteger >C<«*><i nteger>3 

Where Integer is an absolute address* 
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4,6,3 MOVE J M 



If a keyv*ord is not specified* source_l ocat ion is 

assumed* 

dest i nati on.expr J Address or address range expression to which 
values are to be moved. Must have one of the following 
forms J 

dest I nat I on_l I ne \ dl =<i n teger>£<,»><i nteger>l 

Where integer is a CY3IL-CC line number generated by 
the cofflpi I er • 

dest i nat I on_of f set « do«< i nteger>C<, . ><i nteger >3 
yhere integer Is an address relative to a module, 

dest i nat i on_l ocati on J dl oc«<i n teger >C <« .Xi nt eger >1 
Where integer is an absolute address. 

If a keyword Is not specified* des t i nat i on_i ocat I on is 

assumed, 

numlocs J ni Number of words to be moved if neither the source 
nor the destination is an address range* Default Is 

one. 

Examples MOVE s loc«ll2 ( 8 ) . ,120{ 8) d I oc«142( 8 ) , .150( 8 ) 

Moves 7 words beginning at 112<octal) to a 7 word field 
beginning at location 142Coctal)* all addresses are 
absol ute , 



4,6.4 HELP 5 H 

This command can provide immediate assistance to a terinlnal 
user about CCD8G features. It acts as a selectively accessed 
on-line information summary* 

help * h C<subject> • <command_name>3 

<subject>s One of the permissible subject categories, 

<command_name>s A CCD8G command identifier or abbreviation. 

If no parameter Is specified* the subject Index is listed. 
This displays all the permissible subject catagories that may be 
entered as parameters to help. 



COMPANY PRIVATE 



CDC - ADVANCED SYSTEHS DEVELOPMENT 
ERS for CY8II-CC Interactive Debugger 



4-33 

09/29/80 
REVJ 



4.0 CCOBS COMNANDS 
4.6.4 HELP J H 



ExainpleJ HELP cnjds (lists all CCD8G command identifiers) 



4.6,5 SAVE. ALL J SAVEA 



This coramand saves all trap* breakpoint and debugger SCL 
procedure definitions* 



save.al I • savea 



f i I e=<name> 



file \ f s The naroe of 
envi ronnent. 

ExanipleJ S AVEA^bi gf i I a 



local file on which to save the 



4*6.6 CHECKPOINT J CK 



This command allows a user to save the CCOBG information 
necessary to return to the debug session at a later time* 

CHECKPOINT saves the current CCDBG environment Cbreakpolnt* 
trap> and debugger SCL procedure definitions)* and current status 
(Interpret and veto mode settings)* output options* default 
module* default proc* CC08G variables and tables* and the user 
program image* on a file. 

Restoration of CCOBG to its status* environment* and user 
program Image is done by issuing the system command DEBUG (RE SUNE * 
f i I ename) « 

file I ft The name of a local file on which the CCDBG environment 
Hiitl be saved. 

Examples CHECKPOINT f'^sf 



4.6.7 QUIT 

This command terminates a CC08G sessi on. 
quit [normal t abort] 
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normals Terminate normally* This Is the default If no parameter 
is specified, 

aborts Causes an abort type of termination to occur* This allows 
abort processing if CCOBG Is being used in a batch job> 
or from a procedure file, 

4 . 7 i:aMa-£iiiiRQ.iia£iii.caaaA!iQS 



4.7.1 SET^VETO J SVE 

This command provides a method of CC08G sequence operation 
that combines the automatic and Interactive modes. When veto 
mode is on# each command in a CCOBG sequence is displayed before 
it is executed* The user is given temporary control at this 
point* The user may allow the command to be executed* skip lt» 
or replace it with one or more new commands* 

set.veto J sve 

4*7*2 CIEAR^VETO \ CVE 

This command terminates veto mode* 

4*7*3 SET^QUTPUT J SO 

This command allows the user to control the kinds of CCOBG 
output that are written to the standard output file* 

set^output « so io«<options> 

los List options* any of the followlngs 

e Error messages 

w Warning messages 

d Debug output produced by command execution 

i Informatiye messages 

r Read command sequence (group or file) when read 

b Body sequence when it occurs (trap or breakpoint) 

t Terminal or standard input file echo 
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The default options when the list Is omitted are 
QfHfdfi* If e is omitted* an auxiliary file must be 
defined with the e option specified. 

Ex amp I el SO lo«{e*w^l) 

4.7.4 SET. AUXILIARY I SAUX 

This command allows a user to define an optional auxiliary 
output file and control the kinds of output that are written to 
it. 

set_auxi I i ary ' saux file«<name> loa<optlons> 

file I fs Name of the file to be the auxiliary output file. 



I OS List options. These define what is to go on the file. 
of the followings 



Any 



e Error messages 

w Warning messages 

d Debug output produced by command execution 

i Informative messages 

r Read command sequence (group or fileJ when read 

b Body sequence when it occurs {trap or breakpoint) 

t Terninal or standard input file echo 

Example? SAUX f-pxidaux lo«(d»r) 



4,7.5 CLEAR, AUXILIARY \ CAUX 



Closes the current aux I I i ary f 1 1 e and clears all the auxiliary 

opt i ons. 



4.7.6 OISPLAY^MAP I OHAP 



This command displays load map information relating to modules 
entry points* and overlays. 



d I s p I a y _m ap I dm ap 



Cmodui e=<name>3 
Coveriay»(<integer>*<integer>)3 
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module I in: A CYBIL-CC compilation unit* If a module is 
specified* its origin* length and all entry points 
contained in it are displayed* 

overlay J ovi: If an overlay is specified* the names of all 
modules in the overlay are listed* 

If no parameter is specified In a non_overlay environment* the 
names of all modules are listed* In an overlay environment* 
designations of overlays are listed* 

Examples OMAP m -ad apt 

Displays loader information about module adapt* 

4,7.7 DISPLAY.DEFAULTS J 00 

This command displays the current default value for module and 
P r c • 

4.7*8 DISPLAY_STATUS t OS 



This command displays information to help the user determine 
the current state of the debug session. 

dl spl ay_s tat us I ds 

The following information is displayed* 

The location of the trap or breakpoint currently 
honored* or the location of user program abort or 
interrupt to be displayed* 

The overlay numbers currently in core and their 
addresses* 

The current terminal output options* 

The name of the current auxiliary output file and the 
current auxiliary output options* 

The current state of veto mode Con or off)* 

The current state of interpret mode < on or off)* 
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4*0 CCDSG COHMANOS 

4.7.8 OISPLAY. STATUS J OS 



The number of breakpoints^ traps* and groups currently 
def i n ed. 



4.7.9 CHANGE. OEFAULTS I CD 



This cofflmand alloi/is the user to change the default values of 
inodule and proc to new identifiers* 

change.def ay I ts 5 cd Cmodul e«<nafne>1 

Cproc«<nanie>3 C <.name> 1 • • • 3 

1 V er I a y « < < I n t e g e r > > < i n t e g er > ) 1 

module * ra: This parameter changes the default module from the 
speclfiedfflodule. 

proc \ pJ This parameter changes the default proc to the 
spec i f I ad proc. 

overlay J oviJ Overlay which contains the new default module or 
proc. 

Examples CD ma zcimtay 

Changes default module to the module with alias 
2 c I m t a y . 
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5*0 ll£SS4^£S_±±±±±±±±±±±± 



5.1 QIiaMDiIIQ«l3£SSA££S 

Oi agnostic messages issued by CCOBG are listed belo»« These 
messages are Issues in one of the following forms: 

♦ERROR - message text 
? 

*CHD - (command text) *£RRQR - message text 

When in coHect mode* some errors* such as those involving 

invalid syntax* are detected and reported prior to being 

collected^ thus allowing them to toe corrected at that time. 

Other errors are not detected until execution of the command is 
attempted* 

Message Significance and Action 

AOORESS IN GO or EXECUTE has been suppl I ed *#i th a location 
ECS/tCH parameter that is an ECS or LCM address. If sup- 
plied* the address must be one in central memory* 

ACTIONS Correct and reenter* 

ADDRESS IM A specified symbolic address implies one contained 
UHLQADEO in an overlay not currently loaded. 

OVERLAY 

ACTION: Confine symbolic addresses to those In 
currently loaded overlays. 

AOORESS An address reference is to a location in DBUG* 
OUTSIDE beyond the first 1008 (approximately) locations* 
USER AREA or beyond the user field length. These locations 
ar e inaccess t b I e to the user. 

ACTION! Reenter with an allow able address. 
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5.0 MESSAGES +++ + 4• ++^-^-++■»■ 

5.1 DIAGNOSTIC MESSAGES 



BAD INDEX 
TYPE i 



8AD 

ORDINAL 
VALUE i 



3AD SYH80L 
TYPE i 



CANNQJ 
CHANGE 
VALUE OF 
ENTIRE 

RECORD OR 
ARRAY 



CANNOT 
EVALUATE 
VARIABLE 
TYPE I 



DEBUG 
INTERNAL 

ERROR 



Internal error. 

action: Submit PSR. 

A variable of type ordinal contains an 
undefined value. 

ACTIONS None. 

Internal error. 

action: Submit PSR 

The CHANGE_VARI ABLE command can only change the 
value of simple variables* such as fields of 
records or elements of arrays* 



ACTION: Reenter with subscript or field notation. 
Internal error. 

ACTION: Submit PSR. 

An error in Debug is preventing further pro- 
cessing. Debug must be aborted. The program 
being debugged could have damaged a portion of D8UG* 

ACTION: Try a new Debug session with all execution 
performed In interpret mode* which protects 



ERROR 
MESSAGES 
MAY NOT BE 
SUPPRESSED 



Completing the current SET QUTPUTf SET 
AUXILIARY, CLEAR OUTPUT* or CLEAR 
AUXILIARY command results in no file being 
designated to receive error messages. 

ACTION: Assign file options consistent with this 
restr I ct i on. 
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5«0 MESSAGES ++-I- + ++++ +++ + 
5.1 DIAGNOSTIC MESSAGES 



EXECUTION 

ADDRESS 

OUTSIDE 

CURRENT 
PROCEDURE 



INVALID 

DESCRIPTOR 
WORD FOR 
ADAPTABLE 
ARRAY 



INVALID 
FIRST* 
LAST OR 
STEP VALUE 



INVALID 
ORDINAL 
VALUE X 



INVALID 

PARAMETER 

xxxx 



INVALID 

VALUE 

SPECIFIED 

FOR 

VARIABLE 

OF TYPE X 



The address specified is outside the current 
proceduref and execution of the command would 
invalidate the stack* 



ACTION: Correct and reenter* 

An Illegal descriptor word was found for 
an adaptable array. 



ACTIONS Use a write trap on the pointer to find the 
point where the descriptor is destroyed* 

A breakpoint has been supplied with an invalid 
frequency parameter. 



ACTION! Check that all such parameters are 

positive. Check that LAST is not less than 
FIRST. Reenter with corrected values. 
First is limited to 262*1^3. Step is 
limited to 4095. 

The value input is not a valid value for this 
var i abl e. 

ACTIONS Correct value and reenter* 

The supplied HELP parameter is invalid. 



I- 1 » V. tii I 



Reenter the HELP command with a valid 
parameter. 

Value type for a variable or subscript 
does not match the value input. 



ACTIONS Verify variable type and reenter in proper 

format. 



COMPANY PRIVATE 



5-4 

COC - ADVANCED SYSTEHS OEVElOPi^ENT 

09/29/80 
ERS for CYBIL-CC Interactive Debugger REVs D 

5.0 HESSAGES +++++ +++ + ++-»■ 
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INTERNAL I n tern a I error • 

ERROR - 

STACK 

UNDERFLOW 

ACTION: Submit PSR* 

INTERNAL Too many ley els of record and array declarations 

ERROR - exist In the variable to allow CCD8G to 

SYfiaOL TOO display it, 

COMPLEX 

ACTIONS Display portions of the record. 

INVALID An overlay trap qualifier other than an overlay 

QUALIFIER designation ^as specified In a SET TRAP* 

FOR LIST TRAP, CLEAR TRAP, or SAVE TRAP 

OVERLAY command, 

TRAPS 



ACTIONS Correct and reenter. 

INVALID A SET.TRAP command has an invalid trap type 

TRAP TYPE parameter value. 

xxxx 

ACTIONS Reenter with a valid trap type* 



LINE An attempt was made to reference a line number 

NUMSERS in an explicitly named or default module 

NOT other than a program 

AVAILABLE compiled with the 0E8UG option, 

ACTIONS Check the home program* 

NO DEFAULT A command has been entered that requires a module 

MODULE specif I cat i on* no module was specified, and no 



ACTIONS Define a default module or reenter command 
with module specified* 

NO ENTRY A reference has been made to an entry point 
POINT XXX name xxxx which does nost exist! or if an overlay 

qualifier has been supplied* it Is not in that 

overlay, 

ACTION! Check spelling or overlay quali fieri correct 

and reenter* 
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NO FILE OR 

PROCEDURE 

XX XX 



NO LABEL 
xxxx 



NO MODULE 
xxxx 



NO 
OVERLAYS 



NO OVERLAY 
(xxxx) 



NO 

VARIABLE 

xxxx 



NON - 
EXISTENT 
FIELD xxxx 



The file or debugger SCL procedure named In a 
READ parameter does not exist* 

ACTIONS Check spelling; check to see if the file is 
logically connected to the job* 

A GOTO command has referenced a label which 
does not exist in the current Debug command 
sequence* 

ACTIONS Correct the Debug sequence accordingly. 

A reference has been made to a module xxxx 
which does not exist; or if an overlay qualifier is 
supplied^ the module is not in that overlay* 
Remember that module is a 1 - 7 character name* 

ACTIONS Correct and reenter* 

An overlay reference has been made in a nonoverlay 
environment. This error Is detected at collect time 
if it occurs in a debugger SCL procedure* or if a 
specific overlay is referenced* 

ACTIONS Confine Debug commands and address 
qualifiers to those acceptable in a 
nonoverlay environment* 

The specified overlay does not exist* DISPLAY.MAP 
indicates all existing overlays* 

ACTIONS Reenter «l th the corrected overlay 
desl gnat I on. 

An attempt was made to reference a CY8IL-CC 
variable xxxx. No such variable exists In the 
referenced or default module or the variable was not 
used. 

ACTIONS Check spelling and the home program* 

Field is not defined in current record. 



ACTIONS Correct and reenter* 
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5.0 MESSAGES +++4 + ^-++ +++ + 

5.1 DIAGNOSTIC MESSAGES 



NOT IN 
COLLECT 
MODE - 
COLLECT.END 
IGNORED 



OPTION 
CODE MUST 

3£ B> 0, 
Ef If R» 
Tf OR W 



POINTER 
VARIABLE 
NOT 
INITIALIZED 



PROC xxxx 
NOT CALLED 



PROC xxxx 
NOT IN 
STACK 



PROGRAM 

HAS 

COMPLETED 



A COLLECT^SND command has been entered when 
not in CO I i ect mode* 



ACTION 



None. 



RECURSIVE 
READ OF 
xxxx 



An invalid option code was specified in the 
option list of a SET.QUTPUT or SET_AUX ILI ARY 

command* 



ACTION! Reenter with all valid option codes* 

A debug command has attempted to evaluate 
a pointer variable that has not been set* 



ACTIONS None. 

TRACE3ACK cannot proceed because the 
specified procedure has ne^er been called* 

ACTION! Enter another command* 

Automatic variables are not available 
because the procedure Is not active* 

ACTION! None. 

An attempt has been made with either GO or 
EXECUTE to continue program execution from 
the point where program termination has been 
r 2 3 c n s u * 

ACTION! Reenter specifying some other execution 
addresses^ or issue QUIT* 

The debugger SCL procedure or file named in 
the current READ parameter is a nested 
procedure or the current sequence* 

ACTION: Redesign sequence logic to avoid this 
Situation* 



COMPANY PRIVATE 



COC - ADVANCED SYSTEfIS DEVEIOPMEHT 
£RS for CYSIL-CC Interactive Debugger 



5-7 

09/29/80 
rev: 



5.0 MESSAGES 4-+'i-+ +++++++ + 

5.1 DIAGNOSTIC MESSAGES 



RELATIVE 

ADDRESS 

OUTSIDE 

BLOCK 



RESPONSE 
QUALIFIER 
MUST 3E 
LINE OR 
SEQ 



SPECIFIED 
VALUE NOT 
IN SET 



STACK 

POINTER 
OUTSIDE 

USER AREA 



SUBSCRIPT 

REQUIRED 
AFTER 
ARRAY xxxx 



SUBSCRIPT 
VALUE i 
OUT OF 

RANGE 



SYMBOL 
NUMBER i 
NOT FOUND 



A module offset is equal to or greater than its 
length. DISPLAY.MAP gives the program length. 



ACTIONS Check for the missing octal suffix C8) on 
the offset value if octal i^as Intended. 
Correct and reenter* 

In response to an error* warning* veto* or 
interrupt of a Debug sequence* a response keyword 
has been followed by text beginning with other 
than LINE* SEQ or * < semi~col on) . 

ACTION' Enter any desired valid response. 

The given value is not In the specified set. 

ACTIONS Correct and reenter. 

An invalid stack pointer has been found. 



ACTIONS None. 

A field of a record was specified after 
an array field in a variable entry 
without specifing a subscript. 

ACTIONS Correct and reenter. 

A subscript value has been specified that is 

outside the T 'aFi'^Q f Of the arfSy. 



ACTION: Correct and reenter. 
Internal error. 

ACTION: Submit PSR. 



COMPANY PRIVATE 



CDC ~ ADVANCED SYSTENS DE^EIQPHENT 
ERS for CY3IL-CC Interactive Debugger 



5-8 

09/29/80 
REV? D 



5.0 MESSAGES +4.+ ^- + + + +f ++ + 

5.1 DIAGNOSTIC MESSAGES 



SYMBOL 

WITH 

RELOCATION 

TYPE i 

NOT 

ACCESSA8LE 



SYNTAX 

ERROR - 
COMMAND 
TOO LONG 



SYNTAX 

ERROR ~ 

DISPLAY. 

MEMORY 

MUST 

PRECEDE 

FORWARD OR 

BACKWARD 



SYNTAX 

ERROR - 
00U3LY 
DEFINED 
PARAMETER 



SYNTAX 

ERROR - 
EXPECTING 



SYNTAX 

ERROR - 
IMPROPERLY 
QUALIFIED 
ADDRESS 



Internal error* 



ACTION: Submit PSR. 

Command with keywords added Is too long 
for buffer. 



ACTION: Break comnand up If possible so fewer 
parameters are needed. 

A DISPLAY. MEMORY cofn^and has not been 
entered. 



ACTIOM: Enter a OISPLAY.MeMQR Y before doing FORWARD 

or BACKWARD. 

The parameter specified in the message has 
been given more that one value. 



ACTION: Correct syntax and reenter* 

An incorrect paratieter type was foynd. 

The message tells what was expected and what 

was found for the specified parameter, 

ACTION: Correct syntax and reenter* 

Either the address parameters are not 
allowed together Cie* proc and location) 
or another parameter is needed with 
them ( i e> module must be supplied 
when proc and overlay are J. 

ACTION: Check syntax* correct and reenter* 
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5»0 MESSAGES ++-i-4'f-+++ + ++ + 

5.1 DIAGNOSTIC MESSAGES 



SYNTAX 

ERROR - 
INVALID 



SYNTAX 

ERROR - 
INTEGER 
OVERFLOW 



SYNTAX 

ERROR - 
INTEGER 
TOO LARGE 



SYNTAX 

ERROR - 
REQUIRED 
PARAMETER 
MISSING 



SYNTAX 

ERROR - 

STRING 

OVERFLOy 



SYNTAX 

4- IN f\ u K 

TABLE 

OVERFLQM 



SYNTAX 

ERROR - 
TOO FEy 



SYNTAX 

ERROR - 
TOO MANY 



The syntax described by the message is illegal* 



ACTIONS Correct syntax and reenter* 

An arithmetic operation has caused the integer 
to become too large. 



ACTION: Check numeric parameters 
persists? submit PSR« 

The value entered is too large* 



If probi em 



ACTION: Correct and reenter* 

The specified parameter must be entered for 
th i s command. 



ACTION: Reenter command specifying the required 
parameter • 

String exceeds maximum allowable length. 



ACTION: Correct and reenter* 
CC03G internal tables are filled. 

ACTION: Submit PSR. 

Not enough of the specified item were input* 

ACTION: Correct and reenter. 

Too many of the specified item were input* 

ACTION: Correct and reenter. 



COMPANY PRIVATE 



CDC - AOVANCeO SYSTEMS DEVeiOPHeNT 
ERS for CY8IL-CC Interactive Debugger 



5-10 

09/29/80 
REV: D 



5*0 MESSAGES l•^■+ + + -»■^'+++^^- 

5,1 DIAGNOSTIC MESSAGES 



SYNTAX 
ERROR - 
UN8AIAHCED 



SYNTAX 

ERROR - 
UNKNOWN 
KEYWORD 



SYNTAX 

ERROR - 
VALUE OUT 

OF RANGE 



SYNTAX 

ERROR - 
VALUE 
RANGE NOT 
ALLOWED 



TOO MANY 
BREAKPOINTS 



TOO MANY 

PROCEDURES 



TOO MANY 
NESTED 
COMMAND 
SEQUENCES 



Parenthesis or brackets are not matched. 



ACTIONS Correct and reenter* 

The specified keyi^ord is not valid for 
this coniffland* 



ACTION? Check syntax^ correct and reenter* 

Parameter value is not within 
allowable range* 



ACTION? Check syntax* correct and reenter* 

A value range was specified for a 
parameter that cannot have a range* 



ACTIONS Check syntax* correct and reenter* 

The nuraber of breakpoints has reached the maxi- 
mum al I o»ed* 

ACTION? One or more existing breakpoints must be 
cleared before any new ones can be set* 

The number of debugger SCL procedures has 
reached the maximum allowed* 

ACTION: One or t7«are existing groups must be cleared 
before any new ones can be set* 

The number of nested debugger SCL procedures has 
reached the maximum allowed* A READ or PAUSE 
command is not allowed until the current 
procedure is terminated and the previous 
procedure is resumed* 

ACTIONS Enter GO to resume the previous sequence 
immedi atel y* 
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TOO MANY 

TRACE 

LEVELS 



TOO MANY 
TRAPS 



UNKNOWN 
COMMAND 



VARIABLE 
NAMES NOT 
AVAILABLE 



X X X X IS 

NOT AN 
ARRAY 

VARIABLE 



X X X X IS 

NOT A 

POINTER 

VARIABLE 



X X X X IS 

NOT A 
RECORD OR 
ARRAY OF 

RECORDS 



The TRACEBACK output has reached its built-in 
feasibility limit. Program logic flow could 
have errors. 

ACTION! Correct and reenter. 

The number of traps has reached the maxinaum 
a I I o^ed. 

ACTION! Clear one or more existing traps before 
setting new ones. 

The coffimand text does not contain a syntactically 
recognizable cofnmand name* If this error occurs 
in a debugger SCL procedure* it is detected at 
collect time. HELP CMOS list all valid 

c m m an d names. 

ACTION! Check spelling. Reenter a valid command. 

The referenced variable in an explicitly named or 
default module must be in a CYBIL-CC program 
compiled with the DEBUG option. 

ACTION! Check the home program. 

A subscript is included in a variable 
declaration for a variable that is not 
type array* 



ACTION 



Correct and reenter* 



A pointer symbol C '^ ) has been used In a 
varjabis dsciaratiorjior a variable that 
is not type pointer. 

ACTION! Correct and reenter* 

A field name has been specified for a 
variable that cannot have fields* 



ACTION! Correct and reenter 
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5.2 WARNING MESSAGES 



5.2 MEMIMS-MSIASES 



Warning messages issued by CCD8G are listed below. These 
messages have one of trie following forsnss 

♦WARN - messagetext 

OK? 

*CMD - Ccoinmand text) '^WARN - message text 
OK? 

These messages indicate by their wording the action that is 
taken if the user responds with a positive acknowledgement (YES* 

ACCEPT* or OK). 

Warning messages can be suppressed by issuing a SET OUTPUT 
command that does not include the W parameter in its option 
list. The action indicated in the message automatically occurs. 
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5.0 MESSAGES f ++4- ++++ + + + + 

5,2 WARNING MESSAGES 



Message 



Significance 



A0APTA8LE STRING 
LENGTH WILL INCREASE 
FROM i TO i 

ADDRESS RANGE WILL 
BE TRUNCATED 



ALL WILL BE CLEARED 



SREAKPOINT WILL BE 
SET AT ENTRY POINT 



EXISTING AUXILIARY 
FILE WILL 8E 
CLOSED 



EXISTING BREAKPOINT 
WILL BE REDEFINED 



EXISTING CHECKPOINT 
FILE WILL 8E 
OVERWRITTEN 

PROCEDURE XXX WILL 
8E REDEFINED 



LINE STARTS IN 
PARCEL 3. 3KPT SET 
IN NEXT WORD. 

LINE n NOT 
EXECUTABLE - LINE m 
WILL BE USED 



This CHANGE. VARIABLE command will 
lengthen the adaptable string variable^ 
and possibly overwrite other data* 

An address range for CHANGE* DISPLAY* 
or MOVE extends beyond the user field 
length or into 08UG* beyond the first 100 
(approximately) locations* 

A CLEAR.TRAP, CL E AR_8RE AKPOINT » or 
CLEAR.PROCEDURE command has been issued 
With no parameters* 



This warning is issued only if the 
specified address is an entry point* 
was not specified as such in a 
SET BREAKPOINT command* 



but 



A SET.AUXILIARY command has been Issued 
which specifies a file name different 
from that of the existing auxiliary 
file. 

An attempt is being made to set a 
breakpoint where one already exists* A 
positive acknowledgement causes the new 
definition to override the old one* 

A CHECKPOINT command has been issued 
giving an existing file name* 



The name supplied in a SET_PROCEDURE 



command is 
PROCEDURE* 
causes the 
old one* 



that of a currently existing 

A positive acknowledgement 
new definition to override the 



One 15 bit instruction for this line 
of the program will be executed before 
breakpoint Is honored. 

The specified line number is not 
executable or is nonexistent* A positive 
acknowledgement causes line m to be used 
I ns tead* 
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PERMANENT 
FILE WILL 
RETURNED 



CHECKPOINT 

8E 



TRAP #n# type* 
qua! I f i ers# WILL 

BE CLEARED 



A CHECKPOINT cofmnand has been Issued 
while a permanent suspend file exists 
without write or modify access. 

A pending SET.TRAP command has a scope 
which overlays the scope of an existing 
trap of the same type. A positive 
acknowledgement CLEARS trap #n* 



5. 2.1 INFORMATIVE MESSAGES 



Informative messages issued by CCD8G are listed below. These 
messages have the forms 

message text 

Informative messages indicate the following: changes in the 
status of CCOBG* changes in the status of commands that process a 
list* commands which confirm specific actions taken* when a list 
element cannot be processed* and when there is no action to be 
taken. 



After the informative message is Issued* CCOBG does not pause 
response* except when the message announces the start or 
"" ' Any remaining elements in a list 



for a 

resumption 



of a CCD8G session. 



are processed after reporting 
processed* 



list element that cannot be 
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Message 



Si gni f i cance 



CY3IL-CC INTERACTIVE 

OESUG 



CY3IL-CC INTERACTIVE 
DE3UG RESTARTED 



CYBIL MODULE 

NEXT, STACK POINTER 

ASSUMED IN REG 82 



0E3UG ABORTED 



DEBUG TERMINATED 



END COLLECT 



IN COLLECT MODE 
U LEVEL n) 



After the program to be debugged has 
been loaded^ this message is issued when 
CCD8G receives control. An initial set 
of traps and/or breakpoints should be 
established at this point before starting 
program execution. 

A CCD3G session has been resumed from 
the point where It was checkpoi nted. The 
system command statement DEBUG 
(RESUME* f i I ename) has been entered 
following the issue of a CHECKPOINT 
command • 

Previous modules In a traceback have not 
been CYBIL-CC modules. Continued 
traceback Is possible only If register B2 
still contains a valid stack pointer. 

This message is Issued in response to 
QUIT ABORT; it appears In the dayfile as 
well « 

This message is issued in response to 
QUIT or QUIT NORMAL; it appears in the 
dayfile as well. 

Sufficient collect. end commands have been 
encountered to reduce the collect level 
to zero* thus ending collect mode. 
Interactive command mode Is resumed; 
entered commands are Immediately 
executed* 

This message occurs when the user 
receives CC08G control in collect mode; 
this was not the case when the user last 
had control. Any subsequent commands 
entered will no longer be executed 
immediately* but will be checked for 
syntax and collected into a debugger SCL 
procedure for future execution. Level n 
is included In the message If a nested 
collect is in effect tn is greater than 
one). To end collect mode* n collect.end 
commands are required* 
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INTERRUPT IGNORED 



INTERRUPTED 



INTERPRET MODE 
TURNED QFF^ 



INTERPRET MODE 
TURNED ON 



NO BREAKPOINT xxxx 



NO BREAKPOINT #n 



NO BREAKPOINTS 



CCD8G Mas already in 
mode when a terminal 
Since the purpose of 
Is to place CCD3G In 



Interactive command 
interrupt occurred* 
a terminal interrupt 
interactive mode* 



the interrupt is ignored* 

A terminal interrupt has occurred while a 
debugger SCL procedure or a command which 
takes a list as a parameter was 
executing. 

As a result of clearing one or more 
traps> no traps remain that require 
interpret mode to be on. Subsequent 
program execution will be by direct 
execution of the machine instructions. 

A SET^TRAP command has been Issued with 
a trap type that requires interpret mode 
of program execution* and> currently* 
interpret mode Is off. Subsequent 
program execution will be by interpreting 
all machine instructions. 

A request has been made to DISPLAY* 
CLEAR* or SAVE a breakpoint at location 
xxxx. No such breakpoint exists* Any 
remaining list elements are processed. 

A request has been made to DISPLAY* 
CLEAR* or SAVE a breakpoint #n which does 
not exist* Any remaining list elements 
are processed. 



There are 
CLEAR* or 



no breakpoints 
SAVE. 



to DISPLAY* 



—¥^ 
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5.0 MESSAGES +++ +++ + +^'++ + 
5,2. 1 INFORMATIVE MESSAGES 



Message 
NO PROCEDURE xxxx 



S i gnl f i cance 



NO PROCEDURES 



NO xxxx TRAP yyyy 



NO TRAP #n 



NO TRAPS 



PAUSE IGNORED FROM 
TERMINAL 



TIME LIMIT 



TRAP NUMBER IGNORED 
in THIS CONTEXT 



A request has been made to DISPLAY* 
CLEAR* or SAVE a debugger SCL procedure 
xxxx s^hich does not exist* Any remaining 
list elements are processed. 

There are no debugger SCL procedures to 
DISPLAY* CLEAR* or SAVE. 

A request has been made to DISPLAY* 
CLEAR* or SAVE a user-defined trap of 
type xxxx with scope yyyy* No such trap 
exists* Any remaining list elements are 
processed. 

A request has been made to DISPLAY* 
CLEAR* or SAVE a user-defined trap #n 
which does not exist. Any remaining list 
elements are processed. 

There are no user-defined traps to 
DISPLAY* CLEAR, or SAVE. Note that the 
three default traps? END* ABORT* and 
INTERRUPT are never displayed* cleared or 
saved. 

This mesage results from entering 

PAUSE while in interactive (non-collect) 

mode. 

A time limit interrupt has occurred while 
either the program or a CCDBG sequence 
was executing. A small amount of time Is 
left* sufficient to do a SAVE^ALL and 
QUIT. To continue the session* enter 
CHECKPOINT, followed by a QUIT and 
DEBUG (RESUME). 

A trap number has been specified as a 
list element in OISPLAY^TRAP* CLEAR.TRAP, 
or SAVE_TRAP command of a form for which 
trap numbers are not allowed* Any 
remaining list elements are processed. 
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5.0 MESSAGES 4- ++ + ++++ + ++-I- 
5,2.1 INFORMATIVE MESSAGES 



USER PROGRAN 
INTERRUPT PENDING 



USER RECOVER 
COMPLETEOf X 
REQUESTED 



ROUTINE 



VARIABLE NAMES NOT 
AVAILABLE FOR xxx 



XXX TREATED AS 



A progr 
execut i 
c o ffl p i I e 
progr es 
i ssued* 
the exe 
compf et 
breakpo 
PAUSE s 
This me 
be give 
than th 
The ter 
Control 
EXECUTE 
to comp 



am I 
on 
d wl 
s« 

the 

cut! 

e<jl» 
in t 
tate 
ssag 
n to 
e re 
mi na 

i s 
9 ca 
I ete 



nterr 
f a C 
th th 
Unl es 

i nte 
on of 

Howe 
or tr 
raent 
e cau 

the 
suit 
I int 
r e g a i 
us I ng 

i ts 



upt was 
Y8IL-CC 
e DEBUG 
s a sec 
rrupt i 

the cu 
y e r * in 
ap wi th 
has bee 
tions t 
user by 
of the 
e r r u p t 
n e d by 

the CY 
executi 



detect 

statera 

parame 

ond int 

s delay 

rrent s 

the in 

no bod 

n encou 

hat con 

some m 

t e r IB i n a 

is ackn 

enterl n 

8IL-CC 

on* 



ed whi i e 
en t 

ter was in 
err upt is 
ed unt i \ 
tatemen t 
ter im> a 
y or a 
n 1 8 r e d • 
trol is to 
eans other 
I Input, 
owl edged. 
g GO or 
statement 



I s 



CC08G issues this message after the user 
program has completed its recover 
routine by making an ABORT or ENORUN 
request* 

Either program xxx is not a CY3IL-CC 
program* or it was not compiled with the 
DEBUG option explicitly specif ied« 

A collect was found following a command 
other than SET^TRAP* SET^BREAKPOINTf or 
SET^PROCEOUREI or a CQLLECT.END was found 
after a statement while not in collect 

mods* 
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6.0 ALBMltllQAL-C 01311 Al^Q-lUtldAEI 



bacKward I bw numi ocs«<i nteger> 

Cformat«oct 1 dec J adr * hex3 

change_def aut ts ! cd C modul e=<name>] 

I proc«<name> C« <nBme>l • • • 3 

C over I ay« C< I nteger>f <i n teger>) 3 

change^memory J cm <address_expr>C!!!odul e*<name>3 

tof fset «<i f^teger>1 val ue»<expr> 
Cnymrocs=<integer>3 Cindi recti 

change.regi sters ? cr a J b J x»<integer> 

value =<expr> Cindi recti 

change.var i ab I e J cv var=<rian}e> value«<expr> 

t modul e«<nafne>lC proc«<name> 
[ ,<name>3 • • • 1 

checkpoint \ ck f i I e-<nai!!e> 

clear^auxiliary I caux 

oJ ear^breakpoi nt \ cb Cscope^exprl 

Cb«<integer>C<«»><integer>lJ 

( <i nteger>£ <« •><! nteger>3 

lI<sep><integer>C<*«><integer>13«»*)3 

Cof f set = <iiiteger>3 

Cover I ay* <<i nteger >* <1 nteger> Jl 

Cmodul e«<narae>3 

cl ear_i nter pr et ' ci 

cl ear_procadure i cp Cprocedur e«<name> J 

C <nanie>C<sep><name>3« « . ) 3 

clear^trap I ct C typea< trap_type>3Cscope_expr 1 

Ct-<lnteger>r<..><lnteger>l« 
(<i nteger>C<*»><integer>3 
t <sep><integer>C <« •><integer>31» • • ) 3 
Cover t ay- {<i nteger>*<i nteger > 13 
C ?!!Odul e*<name>3 Cproc=<natne> 
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[•<r»ame>3 ••• 1 



cl ear.veto * eve 



di spl ay^braakpo int J db t address. exprl 

Cb«<integer>C<.«><integer>3J 

(<i nt eg er>C<. •>< Integer >1 

C<sep><integer>C<««><integer>31».»)3 

Coffset»<lnteger>] 

C V e r I a y = C< i n t e g e r >» < i n t e g er > ) 3 

Cinodu I e = <name>3 



di spi ay.def aul t I dd 
dispiay_map J dfflap 

di sp I ay.raemory « dm 



Cmody I e = <nafne>3 
Coverlay={<integer>><integer>)3 

<address_expr> 

Cformat=oct J dec * adr J hex3 

tnuml ocs*<i nteger>3 

Coffset«<integer>3Cmodule»<naffle>3 

[indirect3 



dl spl ay_pro cedure * dp C pr ocedur e-<nanue> J 

{ <naine>C<sep><name>3«»» ) 3 

di sp I ay_r eg is ters J dr Cp J fi ' Ca J b ' x = C<i nteger >3 3 3 

t foriiiat«oct ; dec 1 adr J hex3 
C I n d i r e c 1 1 



d i sp I ay_s tatus J ds 
dlsplay_trap 1 dt 



d i s P I a y_ v ar i a b I e I d v 



execute 'ex 



Ctype«<trap„type>3Cscope_expr3 

rt=<integer>r<«.><integer>3? 

( <i nteger>C <••><! nteger>3 

C<sep><integer>t<*»><integef>3 3»»«)3 

Coverlay»<lnteger>#<lnteger>)1 

Cmodul e=<name>3 Cproc»<name> 

C •<naiiie>3»« . 3 

C var*<name>3 

C f armat^oct I dec S hex 3 
Cfnodul e»<name>3 C proc«<name> 
C •<name>3 •* • 3 

C addressee xpr 3 C of f set = <in teger>3 
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for war d T f w 

go 

goto 

help : h 
label r I a 

message I me 
move J in 

pause t pa 

qui t 

read * r 

save_a 1 1 I savea 



numlocs»<integer> 

Cformat»oct t dec J adr S hex3 

Caddress_expr3 Coffset»<integer>l 

I abel »<name> 

C<subject> 1 <con!mand_name>3 

name»<name> 

Ctext««C<asGi i>].,,» J 

source_expr desti nati orj_expr 
Cnumlocs-<lnteger>3 

C 1 8 X t a • C < a s cl I > 3 • * • • ] 

C norma I I abort 3 

file ; procedure « <name> 

f i ie«<name> 



save^br eakpoint 1 saveb f 1 1 e=<naiie>£scope_expr3 

£b«<integer>C<«.><lnteger>3* 

C<integer>C<.«><lnteger>3 

C<sep><integer>C<.»><integer>33*««)3 

Cof fset «<i nteger> 3 

Coverlay»C<integer>*<integer>)1 

C modul e«<name>3 

save^procedure J savep flle«<name> 

tproc8dure=<name> 5 

C <name>C<sep><name>1* • . ) 1 

save_trap » savet f i I e = <na!ne> Ctype»<tr ap_type>3 

£scope_expr3 

Ct«<integer>C<»»><integer>3 * 
C<i nteger >£<••>< integer >3 
C < s ep >< i n t e ger > C <« * >< i n t eg er > 3 3 • • • ) 3 
Caverlay»C<integer>^<integer>)3 
Cmodul e»<naine>3 Cproc»<name> 
C • <name>l«» . 3 

set^auxi I i ar y \ saux flle-<nanie> lo»<options> 
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set_breakpo int J sb 



set^in terpret J si 
set^output J so 
set^procedure T sp 

set^trap * st 



set^veto J sve 
s k I p I f I s 

tr aceback T tb 



I address^expr 1 

Cmodule«<nain€>3Coveflay«{<integer> 
»<lnteger>) 3 £offset«<integer>3 
Cflrst=<lnteger>3 C!ast«<integer>3 
Istep«<integer>3 C<coriect><eolJ;> 
C <comfnand_statement><eo 1 * ; >3« •• 
<co I I ect_end>3 



I o«<opt ions> 

pr ocedure-<name> C<col I ectXeol J ?> 
C<comfJiand_statefnent><eol » ;>1««* 
<co 11 ect_end>3 

type*<trap_type> Cscope_expr3 
Coyer*ay*(<integer>><lntegef>)3 

[ modul e«<naiTie>3 Cproc = <name> 
C» <name>3* • • 3 C <col I ectXeol J |> 
C<co}B!n3nd_st atemen tXeol * 5>3» • • 
<col I ec t_end>3 



<vaiue_l><rel ati onXval ue_2> 
Centrypolnt«<na!ae>3 



CQMPAHY PRIVATE 



1 

09/29/80 



Table of Contents 



1.0 SCOPE ••«•••«••••.«•••••«•••••« 1-1 

1.1 APPLICABLE DOCUMENTS *.••,..«.««.,•,.•• 1-1 

2.0 INTRODUCTION ••••...,•*••..•.••**•. 2-1 

2.1 OVERVIEW .•.••••. . . • 2-1 

2.2 TERIilNOLOGY •«•«•••,..*•• * •.•••... 2-2 
2*3 METALANGUAGE •«,«•«•«•••••••••««••• 2-3 

2.4 BASIC CONCEPTS ..*.....•...*••.••... 2-4 

2.4.1 INTEGER ...«..«.•«•«.«•••••••« 2—4 

2.4.2 NAME ...«•«..»..••.....••«.«• 2-5 

2.4.3 ADDRESS .........*...........• 2-5 

2.4.4 CC08G VARIABLES •«••.••••••«.••.•• 2-5 

2.4.5 EXPRESSION (EXPR) .,..........••.,, 2-6 

2.4«oSfcrARArOR . . . . . . . . . « « • « • « . « • « . • 2— D 

2 • 4 . 7 C Onn EM TS . • . . « • * • . . » . . • • . ♦ . . ♦ « . 2—6 

2.4.8 COMMAND ...................... 2-7 

2.4.9 PARAMETER LISTS ..*,.•••.••••.,••• 2-7 

2.4.10 VALUE LISTS .««.••,••.,..•••«..• 2-7 
2*4.11 CONTINUATION •...••«•••..••••••. 2-8 

3.0 GENERAL DESCRIPTION OF CCDBG USE •••.••••«.•, 3-1 

3.1 PROGRAM EXECUTION CONTROL ,•«.•...••«.... 3-2 

3.2 CY3IL-CC SOURCE SYMBOL REFERENCE CAPABILITY ...... 3-2 

3.3 MACHINE LEVEL DEBUGGING FEATURES , . ........ . . 3-2 

3.4 OVERLAY ENVIRONMENT ......«.......*... 3-3 

3.5 DEBUGGER SCL PROCEDURE ..«.••••.•••.•••. 3-3 

3.6 CONDITIONAL COMMAND EXECUTION CAPABILITY ........ 3-3 

3. 7 VETO MODE ....*«..«..«..•......«. 3—3 

3.8 DEFINITION FILE CAPABILITY ...*...*...*... 3-3 

3.9 CHECKPOINT/RESTART CAPABILITY «««•.•.•,*•.• 3-4 

3.10 WARNING CAPABILITY .................. 3-4 

3.11 CCDBG VARIABLES •,....«•«.••••«..••. 3-4 

3.12 INFORMATION OUTPUT •...••••«..••«•••• 3-4 

3.13 HELP COMMAND .*.......,.......•,.. 3-4 

4.0 CCDBG COMMANDS .... . , •.•..•••«.«•«.. 4-1 

4.1 BREAKPOINTS AND TRAPS .•.•«••*••«•«,.«• 4-1 

4*1.1 SET^BREAKPOINT T SB . . . • . . * . . . . . . . . . 4-1 

4.1*2 SET^TRAr « ST ..•«**...«.«.«.**«• 4—3 

4,1.3 OISPLAY.BREAKPOINT 1 OB ..*.*..**..... 4-6 

4*1.4 OISPLAY^TRAP J OT . •.«•..*.••*••••• 4-7 

4.1.5 SAVE_3«£AKP0INT T SAVES ..*....*.*.•., 4-9 

4.1.6 SAVE.TRAP J SAVET ,,,.......•*...., 4-11 

4.1.7 CLEAR.BREAKPQINT i C8 * *«*««•.*•,., . . 4-12 
4.1*3 CLEAR^TRAP J CT .••.«,.•.****•*•* . 4-14 
4*1*9 SET.INTERPRET ? SI .*,,,, ••,*.•.,.* , 4-16 
4.1,10 CLEAR. INTERPRET t CI ..**•*..,,*.... 4-16 

4.2 DISPLAYING AND CHANGING PROGRAM VARIABLES , .... , , 4-16 
4.2.1 0ISPLAY.VARIA3LE I OV *•«••,•**««•..* 4-16 



09/29/80 



4. 2,2 CHANGE.VARIA3LE J CV •..••••*..•.•., . 4-18 

4.3 DISPLAYING AND CHANGING HEMQRY AND REGISTERS •.•••• 4-18 

4. 3.1 DISPLAY.HEHORY J ON *....••.•••••••• 4-19 

4.3.2 FORWARD J FW •.«••«..«•«•••....• , 4-20 

4.3.3 BACKWARD J 8W •,••••«••«••••«•••• 4-21 

4.3.4 CHANGE.HEMORY J CH ................ . 4-21 

4.3.5 OISPLAY.REGISTERS J OR .............. . 4-22 

4.3.6 CHANGE.REGISTERS J CR ...•.••..«••..« 4-23 

4.4 DeaUGGER SCL PROCEDURES .•••...•.••.,..• 4-24 

4.4.1 SET^PROCEOURE J SP ................ . 4-24 

4.4.2 DISPLAY. PROCEDURE J OP .............. . 4-24 

4.4.3 SA\/E_PROCEDURE J SAVEP .••...«....«..• 4-25 

4.4.4 CLEAR.PROCEDURE 1 CP ............... . 4-25 

4.5 DEBUGGER SCL PROCEDURE COMMANDS .....••...•• 4-26 

4.-).lPAU5E« PA.. . . . . . « . . «. . .. . ... . . 4'~2 6 

4.5.2 NESS AGE ! NE •.«•...•••«••...,.. . 4-26 

4.5*3 GO ••.•.••«..••....••«..... « 4-27 

4.5.4 SKIPIF I S .................... , 4-28 

4.5.5 LABEL* LA. « . . . • . . . . .. . .. . . .. • • 4—28 

Th.P.oGOru. . . . . . . . . . . . . . . . .. . . .. . . 4"~ 2 9 

4.5.7KcAu« R « . . . . . . . . .. . . . . . . . « . . . 4'— 2 9 

4.6 ADDITIONAL INTERACTIVE NODE CQHNANDS ........«• 4-30 

4.6.1 EXECUTE « EX . . . . . . . « . . . . . . . . . . . . 4— 3 

4.6.2 TRACE3ACK S TB .•...«.,.,«•«.•... . 4-30 

4.6.3 MOVE S N .«......•.«.»•....,.. . 4-31 

4.6.4HELPJ H. . « . . . . . . . « . . « .« . . «. . . 4— 3 2 

4.6.5 SAVE^ALL \ SAVEA .«..•*....••...•.. 4-33 

4.6.6 CHECKPOINT J CK ....•..••..,..,... 4-33 
4. 6. /QUIT.. ... ... ...... . .... ... .« 4— 3 3 

4.7 CCD8G ENVIRONMENT COMMANDS ............... 4-34 

4.7.1 SET.VETO J SVE .................. . 4-34 

4.7.2 CLEAR.VETO \ CVE •....,.••....«•«.. 4-34 
4.7*3 SET.OUTPUT S SO .«...«.....,•••.,. 4-34 

4.7.4 SET.AUXILIARY I SAUX ................ 4-35 

4.7.5 CLEAR.AUXILIARY I CAUX ............... 4-35 

4.7.6 DISPLAY.MAP J OMAP ••..•••.•.,*.*•.. 4-35 

4.7.7 DISPLAY. DEFAULTS J DO ............ . . . 4-36 

4.7.8 DISPLAY.STATUS J OS ...,•.««.,..,... 4-36 

4.7.9 CHANGE.OEFAULTS T CO ............... . 4-37 

5.0 MESSAGES +++ + + ■!■++ + 4-+ -i- .......... . . , , . . . 5-1 

5.1 DIAGNOSTIC MESSAGES *•..••...• . . . . . , , • 5-1 

5.2 WARNING MESSAGES ,•..•«.,•...•..,•••* 5-12 
5*2.1 INFORMATIVE MESSAGES •.,•••••«...••.• 5-14 

6.0 ALPHABETICAL COMMAND SUMMARY •....««••,*•.« 6-1 



